spring boot 应用在生产环境上传大于 100mb 的文件时出现 503 错误，且请求未到达控制器，根本原因常是 multipart 功能未显式启用——即使配置了大小限制，`spring.servlet.multipart.enabled=true` 缺失会导致 tomcat 拒绝解析 multipart 请求体，直接返回 503。

在 Spring Boot 中，multipart 支持默认是禁用的（enabled=false），尤其在较早版本（如问题中使用的 Spring 5.0.8.RELEASE）中，仅设置 max-file-size 和 max-request-size 并不足以激活 multipart 解析器。当 Postman 发送大文件的 multipart/form-data 请求时，若 multipart 未启用，嵌入的 Tomcat（或底层 Servlet 容器）会直接拒绝该请求，甚至不将请求转发至 Spring MVC 生命周期，因此你观察不到任何日志、控制器也完全收不到调用——这正是 503 “Service Unavailable” 的典型表现（容器层面拦截，非应用层异常）。

✅ 正确配置需三步到位（application.properties）：

# ✅ 必须显式启用 multipart 支持（关键！）
spring.servlet.multipart.enabled=true

# ✅ 设置单文件与总请求体上限（单位：B/K/M/G，支持后缀）
spring.servlet.multipart.max-file-size=500MB
spring.servlet.multipart.max-request-size=500MB

# ✅ 针对内嵌 Tomcat 的额外缓冲区限制（Spring Boot 2.x+ 推荐用 server.tomcat.max-swallow-size）
server.tomcat.max-http-form-post-size=500MB
# （Spring Boot 2.3+ 更推荐：server.tomcat.max-swallow-size=500MB）

⚠️ 注意事项：

• spring.servlet.multipart.enabled=true 是前提条件，缺失则其余配置全部失效；
• 本地 localhost 测试成功而生产环境失败，极可能因反向代理（如 Nginx、ALB、API Gateway）或负载均衡器设置了更严格的请求体限制（如 Nginx 默认 client_max_body_size=1M），需同步检查并调整代理层配置；
• 若使用云平台（如 AWS ALB、Cloudflare），确认其支持大文件上传且未启用“请求体扫描”等中间件拦截；
• 生产环境建议添加超时优化（如 server.tomcat.connection-timeout=600000），避免大文件上传因超时中断；
• Controller 层保持简洁，大文件建议异步处理 + 进度反馈，避免阻塞主线程。

? 验证方式：
启动后访问 /actuator/env（需启用 Actuator），搜索 multipart，确认 spring.servlet.multipart.enabled 值为 true；同时抓包或查看 Tomcat access 日志，确认大文件请求是否真正抵达容器端口。

综上，503 并非代码逻辑错误，而是基础设施层的“准入开关”未打开。补全 enabled=true 后，配合合理的大小与超时配置，即可稳定支持百 MB 级文件上传。

# nginx  # app  # access  # 端口  # tomcat  # ai  # spring mvc  # gate  # mvc  # spring  # spring boot  # 中间件  # gateway  # postman  # servlet  # 线程  # 主线程  # 异步  # 负载均衡 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： php静态变量怎么调试_php静态变量作用域调试技巧【解答】  Laravel如何使用软删除（Soft Deletes）功能_Eloquent软删除与数据恢复方法  如何在自有机房高效搭建专业网站？  香港服务器建站指南：外贸独立站搭建与跨境电商配置流程  Laravel Fortify是什么，和Jetstream有什么关系  利用JavaScript实现拖拽改变元素大小  Laravel怎么实现一对多关联查询_Laravel Eloquent模型关系定义与预加载【实战】  php485函数参数是什么意思_php485各参数详细说明【介绍】  EditPlus 正则表达式 实战(3)  javascript基于原型链的继承及call和apply函数用法分析  JavaScript如何实现继承_有哪些常用方法  如何快速查询域名建站关键信息？  三星、SK海力士获美批准：可向中国出口芯片制造设备  如何快速查询网站的真实建站时间？  如何利用DOS批处理实现定时关机操作详解  如何在腾讯云免费申请建站？  如何快速搭建高效香港服务器网站？  详解免费开源的DotNet二维码操作组件ThoughtWorks.QRCode（.NET组件介绍之四）  Laravel如何使用缓存系统提升性能_Laravel缓存驱动和应用优化方案  如何续费美橙建站之星域名及服务？  html文件怎么打开证书错误_https协议的html打开提示不安全【指南】  Laravel怎么调用外部API_Laravel Http Client客户端使用  Laravel怎么进行浏览器测试_Laravel Dusk自动化浏览器测试入门  Python并发异常传播_错误处理解析【教程】  如何在搬瓦工VPS快速搭建网站？  LinuxShell函数封装方法_脚本复用设计思路【教程】  Laravel怎么使用artisan命令缓存配置和视图  Laravel中的withCount方法怎么高效统计关联模型数量  EditPlus中的正则表达式实战(5)  大连网站制作费用,大连新青年网站，五年四班里的视频怎样下载啊？  Laravel如何实现一对一模型关联？（Eloquent示例）  如何快速搭建高效简练网站？  php后缀怎么变mp4格式错误_修改扩展名提示格式不对怎么办【技巧】  打开php文件提示内存不足_怎么调整php内存限制【解决方案】  高性价比服务器租赁——企业级配置与24小时运维服务  微信小程序 require机制详解及实例代码  Laravel如何使用Spatie Media Library_Laravel图片上传管理与缩略图生成【步骤】  laravel怎么实现图片的压缩和裁剪_laravel图片压缩与裁剪方法  Win11搜索不到蓝牙耳机怎么办 Win11蓝牙驱动更新修复【详解】  linux top下的 minerd 木马清除方法  Laravel怎么实现微信登录_Laravel Socialite第三方登录集成  Laravel如何处理表单验证？（Requests代码示例）  香港服务器租用费用高吗？如何避免常见误区？  什么是JavaScript解构赋值_解构赋值有哪些实用技巧  微博html5版本怎么弄发超话_超话进入入口及发帖格式要求【教程】  Laravel怎么自定义错误页面_Laravel修改404和500页面模板  魔方云NAT建站如何实现端口转发？  Laravel Sail是什么_基于Docker的Laravel本地开发环境Sail入门  Java垃圾回收器的方法和原理总结  如何用腾讯建站主机快速创建免费网站？