Spring MVC 與 Tomcat 靜態資源處理機制：配置策略與優先級完整解析

靜態資源處理兩大機制

Java Web 專案中靜態資源（JS、CSS、圖片等）可由兩種方式處理：

方案一：啟用 Tomcat DefaultServlet（推薦生產環境）

web.xml 精確映射配置

<servlet-mapping>
  <servlet-name>default</servlet-name>
  <url-pattern>*.js</url-pattern>
</servlet-mapping>
<servlet-mapping>
  <servlet-name>default</servlet-name>
  <url-pattern>*.css</url-pattern>
</servlet-mapping>
<servlet-mapping>
  <servlet-name>default</servlet-name>
  <url-pattern>*.png</url-pattern>
</servlet-mapping>
<servlet-mapping>
  <servlet-name>default</servlet-name>
  <url-pattern>*.jpg</url-pattern>
</servlet-mapping>
<servlet-mapping>
  <servlet-name>default</servlet-name>
  <url-pattern>*.gif</url-pattern>
</servlet-mapping>
<servlet-mapping>
  <servlet-name>default</servlet-name>
  <url-pattern>*.ico</url-pattern>
</servlet-mapping>
<servlet-mapping>
  <servlet-name>default</servlet-name>
  <url-pattern>/static/*</url-pattern>
</servlet-mapping>

url-pattern 三種匹配規則

方案二：Spring MVC 資源處理（開發便利）

spring-mvc.xml 配置

<!-- 靜態資源映射：位置 /resources/ 對應 URL /resources/** -->
<mvc:resources location="/resources/" mapping="/resources/**"/>

<!-- 預設 Servlet 處理器：將未匹配請求轉給容器 DefaultServlet -->
<mvc:default-servlet-handler/>

資源鏈進階配置（Spring 4.1+）

<mvc:resources mapping="/assets/**" location="/public/">
  <mvc:resource-chain resource-cache="true" auto-registration="true">
    <mvc:resolvers>
      <mvc:version-resolver>
        <mvc:content-version-strategy/>
      </mvc:version-resolver>
      <mvc:path-extension-resolver/>
    </mvc:resolvers>
    <mvc:transformers>
      <mvc:cache-control-transformer cache-period="31536000"/>
      <mvc:gzip-transformer/>
    </mvc:transformers>
  </mvc:resource-chain>
</mvc:resources>

HandlerMapping 執行順序與優先級

原則：Order 數值越小優先執行。Controller 映射 > 靜態資源 > DefaultServlet 代理。

最佳實踐策略

生產環境：容器原生 + Spring 後備

<!-- 1. 精確副檔名交給 Tomcat DefaultServlet -->
<servlet-mapping>
  <servlet-name>default</servlet-name>
  <url-pattern>*.js</url-pattern>
</servlet-mapping>
<servlet-mapping>
  <servlet-name>default</servlet-name>
  <url-pattern>*.css</url-pattern>
</servlet-mapping>
...

<!-- 2. 目錄級交給 DefaultServlet -->
<servlet-mapping>
  <servlet-name>default</servlet-name>
  <url-pattern>/static/*</url-pattern>
</servlet-mapping>

<!-- 3. Spring MVC 兜底：處理資源版本、壓縮等進階功能 -->
<mvc:resources mapping="/resources/**" location="/resources/"/>
<mvc:default-servlet-handler/>

開發環境：Spring MVC 統一處理

<mvc:resources mapping="/**" location="/static/"/>
<mvc:default-servlet-handler/>

常見問題排查

Spring Boot 自動配置對應

# application.yml
spring:
  mvc:
    static-path-pattern: /static/**
  resources:
    static-locations: classpath:/static/,classpath:/public/
    chain:
      enabled: true
      compressed: true
      cache: true
      strategy:
        content:
          enabled: true