上传文件时,页面提示“413 Request Entity Too Large”,或者接口直接返回 413,常见原因是请求体超过了链路中某一层的大小限制。拦截请求的可能是负载均衡、WAF、Nginx、应用框架,也可能是函数计算等服务。只调整一处配置,未必能解决问题。
不同阿里云产品和软件版本的限制并不相同。排查时应以实际控制台配置和对应产品文档为准,先找出哪一层返回了 413,再调整相关设置。
阿里云 413 表示什么
413 是 HTTP 状态码,表示服务器拒绝处理过大的请求内容。上传文件是常见场景,但图片、视频、表单字段和较大的 JSON 数据也可能让请求体超过限制。
请求通常会经过客户端、DNS/CDN、WAF、负载均衡、ECS 上的 Web 服务,最后到达应用程序。链路中任何一层设置的上限低于实际请求体大小,都可能触发阿里云 413。阿里云没有一个适用于所有产品的统一开关,需要按实际请求路径逐层检查。
先确认是哪一层返回了 413
先别急着重启服务,也不要把所有限制一并调大。下面几项检查通常能缩小范围:
- 查看请求是否到达源站。对照负载均衡、WAF、Web 服务和应用日志。如果应用没有这条请求记录,拦截可能发生在应用之前。
- 比较不同访问路径。直接访问源站正常、经过 CDN 或 WAF 才失败,优先检查中间层;两种方式都失败,再查源站和应用配置。
- 核对请求体大小。浏览器显示的文件大小不一定等于完整请求体大小。使用
multipart/form-data时,边界和表单字段也会占用一些空间。 - 结合响应和日志判断。查看响应头、错误页面特征及各层日志。页面上出现“阿里云”字样,不足以证明是云平台本身拦截。
常见原因与处理方式
1. Nginx 的请求体上限偏小
源站使用 Nginx 时,可以检查 client_max_body_size。如果该值低于上传请求体大小,Nginx 会拒绝请求。例如:
client_max_body_size 50m;
这个配置可以放在 http、server 或 location 配置块中,具体生效范围取决于请求匹配到的位置。修改后先运行 nginx -t 检查语法,再按部署方式平滑重载。如果改了配置却没有变化,检查请求是否命中了另一个配置块。
不要为了绕过报错就设成无限制。大请求会占用连接、内存和磁盘资源,也可能给服务带来额外风险。
2. WAF、负载均衡或其他入口层限制
经过 WAF、负载均衡、CDN 或 API 网关时,还要核对对应服务的请求体限制、规则和产品能力边界。不同产品的设置方式并不相同,别直接照搬其他产品的参数。
如果只有经过某个入口才报错,可以在不影响业务的前提下,对照入口日志和源站日志,确认请求停在哪一跳。涉及 WAF 规则时,先查清拦截原因,再调整适用规则或上传方案,不建议直接关闭防护。
3. 应用框架或运行时限制
请求到达应用后,也可能被框架、上传组件或语言运行时拒绝。Java Web 项目需要检查 multipart 上传大小配置;PHP 项目常要核对 upload_max_filesize 和 post_max_size。其他框架也可能有自己的请求体上限。
代理层和应用层的限制都要满足业务需要:代理层允许的大小不能低于应用实际要接收的大小,应用配置也要与上传需求匹配。配置项会随框架版本和部署方式变化,修改后按需重启或重新加载服务,并用接近上限的文件测试。
4. 请求格式或传输方式不合适
文件本身不大,请求体却超限,可能是前端把文件转成 Base64 后放进 JSON,导致数据体积增加;也可能把完整文件内容放进普通表单字段。上传文件通常使用合适的 multipart 请求,避免不必要的编码和重复传输。
案例:小文件能传,大文件失败
某团队通过自建业务接口上传图片,几百 KB 的文件可以正常提交,十几 MB 的文件却让前端收到 413。团队一开始怀疑云服务器带宽不够,升级机器后,问题仍然存在。
检查请求链路后发现,流量经过入口服务转发到 ECS,源站 Nginx 的请求体上限设置得较低。小图片没有超过限制,大图片则在到达应用前被 Nginx 拒绝,所以应用日志里没有对应记录。团队按业务需求调整 Nginx 限制,同时核对应用的 multipart 配置,再通过不同大小的文件和不同入口路径测试,确认上传成功且其他接口没有受到影响。
这个场景里,升级带宽和机器规格都没有解决问题。决定报错的是 Nginx 的请求体上限,排查重点应放在实际拦截请求的那一层。
大文件可考虑分片上传或 OSS 直传
上传大视频、压缩包或大量文件时,可以评估对象存储的服务端授权直传方式:客户端拿到短时有效的授权后,直接把文件上传到 OSS,减少文件经过业务服务器的次数。大文件还可以结合分片上传和断点续传。
直传需要控制好授权范围。授权应限定有效时间、对象路径和允许的操作;文件上传后,服务端还要校验类型、大小和业务归属。不要把长期有效的访问密钥写进前端代码。
排查阿里云 413 时检查这些项目
- 确认是所有请求失败,还是只有文件超过某个大小才失败。
- 沿请求链路查日志,找到第一个返回 413 的服务。
- 逐项核对入口层、Nginx、应用框架和上传组件的大小限制。
- 按业务需要设置上限,并为请求体中的额外内容留出空间。
- 调整后通过真实入口测试不同大小的文件,同时留意资源消耗和安全风险。
阿里云 413 通常是请求体在链路中的某个环节超过了限制。先定位拦截层,再调整对应配置。若业务经常上传大文件,可以评估分片上传或 OSS 直传,避免让完整文件反复经过业务接口。