Spring MVC與Spring Boot文件上傳配置項對比

---

一、Spring MVC配置項（基于不同MultipartResolver實現）

---

1. 使用 CommonsMultipartResolver（Apache Commons FileUpload）

@Bean
public MultipartResolver multipartResolver() {CommonsMultipartResolver resolver = new CommonsMultipartResolver();resolver.setMaxUploadSize(10485760); // 10MBresolver.setMaxInMemorySize(4096);   // 4KBresolver.setDefaultEncoding("UTF-8");resolver.setUploadTempDir(new FileSystemResource("/temp/upload"));return resolver;
}

配置項	描述	默認值	作用域
maxUploadSize	允許上傳的文件總大小（字節）	-1（無限制）	全局限制
maxInMemorySize	內存中臨時存儲的最大大小（超過則寫入磁盤）	10240（10KB）	內存與磁盤切換閾值
defaultEncoding	請求編碼格式	ISO-8859-1	解析文件名和參數編碼
uploadTempDir	臨時文件存儲路徑	系統默認臨時目錄	自定義臨時目錄路徑
resolveLazily	延遲解析請求（避免大文件阻塞）	false	控制請求解析時機

---

2. 使用 StandardServletMultipartResolver（Servlet 3.0+）

無需手動配置MultipartResolver屬性，但需通過Servlet容器配置參數控制：

<!-- 在web.xml中配置Tomcat參數 -->
<Context><Parameter name="maxFileSize" value="10MB" override="false"/><Parameter name="maxRequestSize" value="10MB" override="false"/>
</Context>

配置項	描述	默認值	作用域
maxFileSize	單個文件最大大小（Servlet容器參數）	無限制	單個文件限制
maxRequestSize	請求總大小限制（Servlet容器參數）	無限制	全局請求限制
fileSizeThreshold	內存與磁盤切換閾值（Servlet容器參數）	0	內存與磁盤切換閾值

---

二、Spring Boot配置項（通過application.properties或application.yml）

# application.properties配置示例
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB
spring.servlet.multipart.location=/temp/upload
spring.servlet.multipart.enabled=true
spring.servlet.multipart.default-charset=UTF-8
spring.servlet.multipart.resolve-lazily=true

配置項	描述	默認值	作用域
spring.servlet.multipart.max-file-size	單個文件最大大小（格式：10MB）	1MB	單個文件限制
spring.servlet.multipart.max-request-size	請求總大小限制（格式：10MB）	10MB	全局請求限制
spring.servlet.multipart.location	臨時文件存儲路徑	系統默認臨時目錄	自定義臨時目錄路徑
spring.servlet.multipart.enabled	是否啟用multipart支持	true	全局開關
spring.servlet.multipart.default-charset	請求編碼格式	UTF-8	解析文件名和參數編碼
spring.servlet.multipart.resolve-lazily	延遲解析請求（避免大文件阻塞）	false	控制請求解析時機

---

三、配置項對比表格

配置項	Spring MVC（CommonsMultipartResolver）	Spring MVC（StandardServletMultipartResolver）	Spring Boot	說明
單文件大小限制	maxUploadSize（字節）	maxFileSize（Servlet容器參數）	max-file-size	Spring Boot支持單位格式（如10MB），而Spring MVC需轉換單位。
總請求大小限制	maxUploadSize（字節）	maxRequestSize（Servlet容器參數）	max-request-size	Spring Boot配置更直觀，支持單位格式。
臨時文件路徑	uploadTempDir	無（依賴容器默認路徑）	location	Spring Boot提供顯式配置。
編碼格式	defaultEncoding	無	default-charset	Spring Boot默認UTF-8，與國際標準一致。
內存與磁盤切換閾值	maxInMemorySize（字節）	fileSizeThreshold（Servlet容器參數）	無	Spring Boot未直接暴露此配置項，需通過容器參數控制。
延遲解析	resolveLazily	無	resolve-lazily	Spring Boot支持此配置，避免大文件阻塞線程。
全局開關	無（需手動配置Bean）	無（需手動配置Bean）	enabled	Spring Boot提供顯式開關。

---

四、關鍵差異總結

1. 配置方式：

   • Spring MVC：需手動配置MultipartResolver Bean（如CommonsMultipartResolver），或通過Servlet容器參數（如Tomcat的web.xml）。
   • Spring Boot：通過application.properties統一配置，無需手動聲明Bean，自動適配容器。

2. 配置項豐富度：

   • Spring Boot：提供更豐富的配置項（如enabled、resolve-lazily），且支持單位格式（如10MB）。
   • Spring MVC：依賴具體MultipartResolver實現類，配置項分散（如CommonsMultipartResolver需Java代碼配置，StandardServletMultipartResolver需容器參數）。

3. 兼容性：

   • Spring Boot：默認啟用StandardServletMultipartResolver，要求Servlet 3.0+容器（如Tomcat 7+）。
   • Spring MVC：若使用CommonsMultipartResolver，需額外引入commons-fileupload依賴。

4. 推薦實踐：

   • Spring MVC：優先使用StandardServletMultipartResolver（Servlet 3.0+），簡化配置。
   • Spring Boot：直接通過配置文件控制，無需關心底層實現細節。

---

五、總結

框架	配置復雜度	依賴要求	推薦配置方式
Spring MVC	高（需手動配置）	需commons-fileupload或Servlet 3.0+	使用StandardServletMultipartResolver + 容器參數
Spring Boot	低（配置文件）	自動包含依賴	通過spring.servlet.multipart.*配置