POST请求上传大文件触发503异常问题排查求助

1. 检查前端反向代理/负载均衡的请求限制 #

如果主服务器前端部署了Nginx、Apache等反向代理服务，这类服务通常会默认限制请求体大小：

• Nginx：查看配置文件（如nginx.conf或站点专属配置）中的client_max_body_size参数，默认值可能为1MB或100MB，需修改为500M或更大，同时调整超时时间避免上传中断：

  http {
      client_max_body_size 500M;
      proxy_connect_timeout 300s;
      proxy_read_timeout 300s;
  }
  

  修改后重启Nginx生效。
• Apache：在httpd.conf或.htaccess中设置LimitRequestBody为524288000（对应500MB），同时调整超时参数：

  LimitRequestBody 524288000
  Timeout 300
  

  重启Apache生效。

2. 排查网络层安全限制 #

• 云服务商的WAF、负载均衡或安全组可能存在默认的请求大小/超时限制，需在控制台将单请求体大小调整至500MB以上。
• 临时关闭服务器本地防火墙（如iptables、firewalld）测试是否恢复正常，若正常则针对性调整防火墙规则，放开大文件请求的限制。

3. 验证Tomcat的完整配置 #

尽管你已在application.properties中配置参数，仍需确认：

• 若使用外部Tomcat而非Spring Boot内嵌版本，需在server.xml的Connector节点中明确设置maxPostSize：

  <Connector port="8080" protocol="HTTP/1.1"
             connectionTimeout="300000"
             maxPostSize="524288000"
             redirectPort="8443" />
  

  （设置maxPostSize="-1"表示不限制请求体大小，更适配大文件场景）
• 检查Tomcat临时文件目录（默认CATALINA_BASE/temp）的磁盘空间，大文件上传会生成临时文件，磁盘满会直接导致上传失败。

4. 服务器资源与系统日志检查 #

• 查看服务器系统日志（如/var/log/syslog、/var/log/messages），确认是否存在Tomcat进程被OOM Killer终止的记录——大文件上传会占用较多内存，若服务器内存不足，系统会强制杀死进程，引发503错误。
• 使用df -h命令检查服务器磁盘空间，确保应用部署目录、临时文件目录所在磁盘未被占满。

5. Postman客户端超时设置 #

服务器环境下网络延迟可能更高，大文件上传耗时更长，需调整Postman的超时设置：

• 打开Postman的「Settings」→「General」，将「Request timeout」设置为300秒（5分钟）或更长，避免客户端提前断开请求导致服务器返回503。

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