Docker Compose部署SpringCloud微服务遇413请求过大错误

你的问题核心是API网关未配置请求大小限制，导致所有经过网关的请求被网关的默认限制拦截，返回413错误——哪怕后端服务已经配置了大文件上传的参数，网关作为请求入口会先做校验。

核心解决方案：配置API网关的请求大小限制 #

在API网关的application-docker.properties（对应docker环境配置）中添加以下参数，覆盖默认的请求大小限制：

# 全局HTTP请求最大大小（匹配后端服务的500MB配置）
server.max-http-request-size=500MB

# 若使用Spring Cloud Gateway，需额外配置客户端内存缓冲区大小（单位：字节，500MB=524288000）
spring.cloud.gateway.httpclient.max-in-memory-size=524288000

原因说明 #

Spring Cloud Gateway默认的max-in-memory-size仅为256KB，server.max-http-request-size默认也很小。所有请求都经过网关转发，网关会先校验请求大小，超过限制就直接返回413，不会转发到后端服务——这就是为什么你本地运行时没问题，但Docker部署后报错，甚至不需要文件上传的stats服务也触发错误（可能是请求头+请求体总和超过了网关的默认限制）。

额外排查步骤 #

1. 确认配置是否生效

   • 重启API网关容器，查看启动日志，确认上述配置被正确加载
   • 若开启了actuator端点，可通过GET /actuator/configprops查看配置参数是否生效

2. 检查非文件上传服务的请求

   • 对于stats这类无文件上传的服务，排查请求是否包含过大的请求头（比如超长的JWT Token），如果是，需调整网关的请求头大小限制：

     server.max-http-header-size=16KB
     

3. 验证Docker网络与服务发现

   • 在API网关容器内通过curl直接访问后端服务的接口，确认是否能正常响应，排除网络转发层面的问题

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