Spring Boot(ECS部署)文件上传端点30秒返回503问题解决

1. 调整负载均衡器的超时设置 #

AWS负载均衡器（ALB/NLB）默认空闲超时通常为30秒，当文件上传耗时超过这个时间，负载均衡器会提前返回503，而后端服务仍在处理上传。

• 登录AWS控制台，找到对应负载均衡器。
• 进入监听器页面，编辑目标HTTP/HTTPS监听器。
• 修改空闲超时参数，根据上传预期耗时调整（比如设为300秒）。
• 同时检查目标组的健康检查超时，确保不会因服务繁忙误判不健康。

2. 优化ECS任务的健康检查配置 #

若ECS任务健康检查的间隔、超时设置过短，服务处理大文件时可能无法及时响应健康检查，导致任务被标记为不健康，负载均衡器停止路由请求。

• 打开ECS控制台，找到对应任务定义。
• 编辑容器配置中的健康检查参数：
  • 增加间隔时间（如从30秒改为60秒）。
  • 延长超时时间（如从5秒改为10秒）。
  • 提高失败阈值（如从3次改为5次）。
• 重新部署任务使配置生效。

3. 调整Spring Boot Web容器的超时设置 #

Spring Boot内置的Web容器（如Tomcat）默认请求超时可能较短，导致容器提前断开连接，但上传线程仍在运行。

• 在application.properties中添加以下配置（以Tomcat为例）：

  # 设置连接超时为5分钟（300000毫秒）
  server.tomcat.connection-timeout=300000
  # 禁用上传文件大小限制（按需调整，也可设具体值如104857600即100MB）
  server.tomcat.max-swallow-size=-1
  

• 若使用Undertow，对应配置为：

  server.undertow.connection-timeout=300000
  server.undertow.worker-threads=64
  

• 重新打包部署应用。

4. 检查客户端超时设置 #

客户端（浏览器、Postman等）的请求超时设置小于上传耗时，也会导致提前收到503错误。

• Postman中可在设置里调整“请求超时”时间；
• 前端自定义上传逻辑时，修改XMLHttpRequest或fetch的超时参数，确保超时时间大于预期上传时长。

内容的提问来源于stack exchange，提问作者Sandy