Postman上传文件返回413错误,基本可确定非Postman自身限制,而是链路中某层拦截:若响应含“nginx/x.x.x”,说明Nginx拦截,需检查client_max_body_size配置位置与生效状态;若响应带Spring字样,则为Spring Boot层限制,需同步调整max-file-size和max-request-size;还需排查PHP、Node.js或Cloudflare等中间层的叠加限制。

Postman 上传文件返回 413 Request Entity Too Large,基本可以确定不是 Postman 自身限制——它默认不限制请求体大小,问题一定出在请求链路的某一层拦截了。你看到的错误页如果带 nginx/1.23.2 或类似字样,说明是 Nginx 拦的;如果是纯空白或 JSON 错误,则可能卡在后端框架或云网关。
Postman 请求被 Nginx 拦截的典型表现
Postman 发送一个 50MB 的 multipart/form-data 请求,直接收到 HTML 响应:,底部还写着 413 Request Entity Too Large
nginx/x.x.x。这说明请求根本没进你的应用,连日志都不会打。
-
client_max_body_size没配,或配在了错误的作用域(比如只写了http块,但你的接口走的是某个location /api,而该location里又没覆盖) - 配置改了但没生效:
nginx -t检查通过 ≠ 配置已加载,必须nginx -s reload或systemctl reload nginx - 用了 Docker 或 Kubernetes?Nginx 配置文件可能挂载错了路径,容器内看到的
nginx.conf和你编辑的不是同一份
Spring Boot 应用层也得同步放开限制
即使 Nginx 放行了,Spring Boot 默认只接受 1MB 的 multipart 请求体,413 会由它自己抛出,响应头里会带 Spring 字样,日志里能看到 MaxUploadSizeExceededException。
- 在
application.yml中加这两项(注意单位写法):spring.servlet.multipart.max-file-size: 500MBspring.servlet.multipart.max-request-size: 500MB - Spring Boot 2.7+ 开始,
max-request-size必须 ≥max-file-size,否则启动报错 - 别信“设成
-1就无限大”——某些版本对负数处理异常,老实用500MB这种明确值
别漏掉 PHP、Node.js 或云服务中间层
如果你的请求路径是 Postman → Cloudflare → Nginx → PHP-FPM,那 Cloudflare 免费版上限是 100MB,企业版才支持更大;PHP 还要单独调 upload_max_filesize 和 post_max_size,且后者必须 ≥ 前者。
- PHP:
upload_max_filesize = 500M、post_max_size = 500M、memory_limit = 512M(三者缺一不可) - Express:
app.use(express.json({ limit: '500mb' })); app.use(express.urlencoded({ limit: '500mb', extended: true })); - Cloudflare:免费计划硬性封顶
100MB,改配置无效,只能升档或绕过(如直连源站 IP 测试)
最容易被忽略的是多层叠加限制:Nginx 设了 500M,PHP 设了 200M,结果上传 300MB 文件还是 413——因为最严的那一环说了算。排查时一定要从客户端出口开始,逐层确认每一环的当前生效值,而不是只改自己觉得“应该管用”的那一层。











