JSP 圖片顯示：Tomcat 配置虛擬目錄映射服務器絕對路徑

JSP 頁面圖片無法顯示？Tomcat 虛擬目錄映射絕對路徑完整配置指南

Web 專案中常需讀取服務器磁盤絕對路徑 (如 /data/uploads/, D:\images\) 下的圖片/文件，但 Web 應用預設僅能訪問部署目錄 (webapps/專案) 內資源。本文詳解 Tomcat Context 虛擬目錄映射配置，實現 JSP <img> 直接引用外部絕對路徑資源。

核心原理

• Context 元素：定義一個 Web 應用的上下文，包含 path (訪問路徑前綴) 和 docBase (物理資源路徑)
• 虛擬目錄映射：將 URL 路徑 /uploads/xxx.jpg 映射到磁盤 D:/data/uploads/xxx.jpg
• 獨立於專案 WAR：資源不隨專案部署/遷移而移動，適合用戶上傳文件、靜態資源共享

配置步驟 (Tomcat 7/8/9/10 通用)

1. 編輯 server.xml

文件位置：$CATALINA_HOME/conf/server.xml

找到 <Host> 元素 (通常為 name="localhost")，在 </Host> 之前添加 <Context>：

2. 參數詳解

3. 重啟 Tomcat 生效

# Linux/macOS
$CATALINA_HOME/bin/shutdown.sh
$CATALINA_HOME/bin/startup.sh

# Windows
%CATALINA_HOME%\bin\shutdown.bat
%CATALINA_HOME%\bin\startup.bat

JSP 頁面使用方式

<%-- 映射配置：path="/uploads" docBase="D:/data/uploads" --%>

  <%-- 相對域名根路徑 --%>

<%-- 若配置 path="/static" --%>

進階配置：META-INF/context.xml (專案級隔離)

若不想修改全局 server.xml，可在專案中定義：

文件：src/main/webapp/META-INF/context.xml

優點：隨專案部署遷移、不影響其他專案、版本控制友好。
缺點：專案重新部署時需重啟生效、多專案共享需重複配置。

Spring Boot 內嵌 Tomcat 配置 (無 server.xml)

@Configuration
public class TomcatConfig {
    
    @Bean
    public TomcatServletWebServerFactory servletContainer() {
        TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory();
        factory.addContextCustomizers(context -> {
            // 添加虛擬目錄映射
            context.getResources().createWebResourceSet(
                WebResourceRoot.ResourceSetType.PRE,
                "/uploads",           // webAppMount
                "D:/data/uploads",    // base (物理路徑)
                "/"
            );
        });
        return factory;
    }
}

或 application.yml：

server:
  servlet:
    context-path: /myapp
  tomcat:
    basedir: /tmp/tomcat
    # Spring Boot 2.5+ 支持
    resources:
      - pattern: /uploads/**
        location: file:D:/data/uploads/

Nginx 反向代理場景 (生產環境推薦)

靜態資源直接由 Nginx 服務，不經 Tomcat，效能更優：

# nginx.conf
server {
    listen 80;
    server_name example.com;
    
    location /uploads/ {
        alias /data/uploads/;  # 直接映射磁盤路徑
        expires 30d;
        add_header Cache-Control "public";
    }
    
    location / {
        proxy_pass https://localhost:8080;  # 轉發動態請求給 Tomcat
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

常見問題排查

安全性最佳實踐

1. 禁止目錄瀏覽：web.xml 設置 listings=false (預設)
2. 敏感文件隔離：上傳目錄與代碼目錄分離，防止 JSP/Servlet 被上傳執行
3. 文件類型驗證：上傳時驗證 MIME、副檔名、魔數，重命名存儲 (UUID + 原副檔名)
4. 訪問控制：私有文件通過 Controller 流式輸出 (檢查權限)，而非直接 URL 訪問
5. 防盜鏈：Nginx valid_referers 或 Tomcat Filter 檢查 Referer