可能原因及解決方案

1. Spring Boot默認文件大小限制

• 原因：Spring Boot默認單文件最大為1MB，總請求體限制為10MB。
• 解決方案：
  • 在application.properties中配置：

    spring.servlet.multipart.max-file-size=10MB  # 單文件最大
    spring.servlet.multipart.max-request-size=100MB  # 總請求體最大
    

2. 服務器容器限制（如Tomcat）

• 原因：嵌入式Tomcat默認最大請求體為2MB（Spring Boot 2.x后默認為無限制，但需確認版本）。
• 解決方案：

  • 通過application.properties全局配置Tomcat：

    server.tomcat.max-swallow-size=-1  # 禁用吞吐限制（慎用）
    server.tomcat.max-http-form-post-size=100MB
    

  • 或在代碼中自定義MultipartConfigElement：

    @Bean
    public MultipartConfigElement multipartConfigElement() {return new MultipartConfigElement(null, 100 * 1024 * 1024L,  // 最大總請求體102 * 1024 * 1024L,  // 溢出限制true);
    }
    

3. 反向代理/負載均衡限制（如Nginx/Apache）

• 原因：Nginx默認client_max_body_size為1m，會攔截過大請求。
• 解決方案：

  • 修改Nginx配置：

    server {client_max_body_size 100m;  # 調整為100MB...
    }
    

  • 重啟Nginx使配置生效。

4. 自定義MultipartResolver配置錯誤

• 原因：自定義MultipartResolver時未正確設置參數。
• 解決方案：
  • 確保配置與Spring Boot屬性一致：

    @Bean
    public StandardServletMultipartResolver multipartResolver() {return new StandardServletMultipartResolver();
    }
    

5. 云服務提供商限制

• 原因：如AWS Elastic Beanstalk、Heroku等平臺有默認大小限制。
• 解決方案：
  • 查閱平臺文檔調整限制（例如AWS需修改代理配置或使用自定義容器）。

---

解決方案對比表格

問題類型	解決方案	適用場景	優缺點
Spring Boot配置不足	修改application.properties的max-file-size和max-request-size	單機開發/簡單部署	? 簡單直接 ? 需重啟服務
Tomcat容器限制	配置Tomcat的max-http-form-post-size或自定義MultipartConfigElement	嵌入式Tomcat部署	? 精確控制 ? 需了解Tomcat配置細節
反向代理限制（如Nginx）	修改Nginx的client_max_body_size	生產環境反向代理部署	? 必要配置 ? 需操作服務器配置
自定義Resolver錯誤	檢查MultipartResolver配置是否與Spring屬性沖突	使用自定義文件解析邏輯	? 解決特定配置問題 ? 需排查代碼
云服務限制	聯系平臺支持或調整云服務配置	云平臺托管環境	? 解決平臺級限制 ? 可能涉及額外費用或復雜配置

---

總結

• 排查順序：先檢查Spring Boot配置 → 反向代理（如Nginx）→ 服務器容器（如Tomcat）→ 云平臺限制。
• 注意事項：
  1. 安全風險：增大文件大小限制可能引發DDoS攻擊，需結合業務場景合理設置。
  2. 內存溢出：大文件上傳建議啟用file-upload到磁盤而非內存（默認配置已處理）。
  3. 配置生效：修改配置后需重啟服務或代理服務器。