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 】

相关推荐： 电商网站制作价格怎么算,网上拍卖流程以及规则？  详解一款开源免费的.NET文档操作组件DocX（.NET组件介绍之一）  Google浏览器为什么这么卡 Google浏览器提速优化设置步骤【方法】  进行网站优化必须要坚持的四大原则  Laravel怎么连接多个数据库_Laravel多数据库连接配置  Laravel怎么实现API接口鉴权_Laravel Sanctum令牌生成与请求验证【教程】  网站制作报价单模板图片,小松挖机官方网站报价？  潮流网站制作头像软件下载,适合母子的网名有哪些？  Zeus浏览器网页版官网入口 宙斯浏览器官网在线通道  JavaScript如何实现路由_前端路由原理是什么  深圳网站制作培训,深圳哪些招聘网站比较好？  Laravel如何处理CORS跨域请求？（配置示例）  laravel怎么用DB facade执行原生SQL查询_laravel DB facade原生SQL执行方法  如何用景安虚拟主机手机版绑定域名建站？  googleplay官方入口在哪里_Google Play官方商店快速入口指南  如何自己制作一个网站链接,如何制作一个企业网站，建设网站的基本步骤有哪些？  ,网页ppt怎么弄成自己的ppt？  如何在万网自助建站中设置域名及备案？  HTML5建模怎么导出为FBX格式_FBX格式兼容性及导出步骤【指南】  Laravel怎么创建控制器Controller_Laravel路由绑定与控制器逻辑编写【指南】  Laravel如何使用Gate和Policy进行权限控制_Laravel权限判定与策略规则配置  javascript和jQuery中的AJAX技术详解【包含AJAX各种跨域技术】  香港服务器租用费用高吗？如何避免常见误区？  邀请函制作网站有哪些,有没有做年会邀请函的网站啊？在线制作，模板很多的那种？  Laravel如何使用Eloquent ORM进行数据库操作？（CRUD示例）  iOS中将个别页面强制横屏其他页面竖屏  Laravel中的withCount方法怎么高效统计关联模型数量  韩国代理服务器如何选？解析IP设置技巧与跨境访问优化指南  Laravel辅助函数有哪些_Laravel Helpers常用助手函数大全  Edge浏览器提示“由你的组织管理”怎么解决_去除浏览器托管提示【修复】  Laravel如何处理文件下载请求？（Response示例）  Laravel如何实现API版本控制_Laravel版本化API设计方案  详解免费开源的.NET多类型文件解压缩组件SharpZipLib（.NET组件介绍之七）  bing浏览器学术搜索入口_bing学术文献检索地址  Laravel PHP版本要求一览_Laravel各版本环境要求对照  如何快速搭建高效可靠的建站解决方案？  Laravel Eloquent：优雅地将关联模型字段扁平化到主模型中  小视频制作网站有哪些,有什么看国内小视频的网站，求推荐？  JavaScript如何实现倒计时_时间函数如何精确控制  Laravel如何使用withoutEvents方法临时禁用模型事件  Laravel如何实现密码重置功能_Laravel密码找回与重置流程  阿里云网站搭建费用解析：服务器价格与建站成本优化指南  个人网站制作流程图片大全,个人网站如何注销？  如何在万网主机上快速搭建网站？  深入理解Android中的xmlns:tools属性  如何用VPS主机快速搭建个人网站？  网站设计制作书签怎么做,怎样将网页添加到书签/主页书签/桌面？  如何在阿里云虚拟机上搭建网站？步骤解析与避坑指南  Laravel 419 page expired怎么解决_Laravel CSRF令牌过期处理  C语言设计一个闪闪的圣诞树