上传文件出现413：按代理、Nginx和应用逐层排查

上传小文件正常、大文件却出现413，通常与请求体大小限制有关。本文按代理、Nginx和应用三层整理检查顺序，帮助你找到实际拒绝请求的位置。

先确定是谁拒绝了上传

上传文件出现413，表示请求内容超过了服务器允许的大小。不要看到页面带有Nginx字样，就认定只有Nginx需要修改。浏览器到应用之间可能经过CDN、反向代理和应用服务器，其中任意一层都可能先拒绝请求。

打开浏览器开发者工具的网络面板，记录失败请求的地址、状态码、文件大小和发生时间。用一个小文件与一个略大文件对照，保持账号和上传入口一致；如果只有大文件失败，优先沿大小限制排查。如果返回的是200但业务提示失败，则还要阅读响应内容，不能直接按413处理。

按请求经过的顺序检查

先核对CDN或网关的上传限制，再查实际处理这个域名和路径的Nginx配置。client_max_body_size可出现在http、server、location层级，因此应确认命中的位置，不能只修改一份看起来像站点配置的文件。需要用nginx -T查看有效配置时，留意输出中可能含有敏感配置，不要整份公开。

如果请求已经进入应用，再检查应用自身及运行时的上传限制。某一层提高上限，不会自动改变其他层。设定与业务相符的有限大小，不建议直接取消全部限制。

怎样确认修复生效

修改前备份配置，完成语法检查后再重载。分别测试允许范围内、接近上限和超过上限的文件，确认前两者成功、最后一种得到清楚提示。同步查看错误日志和应用日志，判断失败发生在哪一层。上传请求还包含表单信息，请求体大小并不总等于文件大小。

参考资料

资料核对日期：2026年10月24日。本文为综合官方文档整理的原创排查指南，未声称进行本站故障实测。

- MDN：413 Content Too Large

- Nginx：client_max_body_size