适用范围与准备
适用于上传附件或提交表单时明确收到 HTTP 413,包括旧提示 Request Entity Too Large 与现行 Content Too Large。本文区分网站使用者与有权管理服务器的人,不把任意“连接失败”都解释为文件大小限制。
先区分原因
413 表示接收请求的一方拒绝过大的请求内容。限制可能来自 CDN、反向代理或应用;只调整最里面的应用不会自动放宽外层。上传表单还有边界及字段开销,文件大小接近上限也可能超过实际请求体限制。
按顺序操作
- 记录失败时间、请求路径、状态码、文件大小及响应中的请求标识,不提供实际附件或认证头。先确认报错是 413,而非下载工具本地限制、磁盘写入失败或 431 请求头过大。
- 网站使用者先查该页面明确给出的附件限制;在允许重复测试的入口用小型非敏感文件比较。可以按网站支持的方式压缩或拆分,不能擅自改变正式材料内容或用反复重试绕过限制。
- 有权限的管理员按时间和请求标识查每一层访问记录。如果应用根本未收到请求,先找外层拒绝的位置;Server 响应头只是线索,不能单凭它断定由哪一层生成。
- 若证据明确指向 NGINX,核对实际命中位置的 client_max_body_size 及继承关系。下面只展示配置项语法;应按业务允许的明确上限,在测试环境定位后修改对应已有 server/location,执行配置检查,再按既有发布流程加载。
- 同时核对外层网关与应用上限,测试低于和高于预期限制的样本。上限提高要有容量和业务依据;不设置 0 关闭所有检查,也不因一个上传入口修改全站限制。
client_max_body_size 8m;| 观察 | 下一步 |
|---|---|
| 小样本通过、大样本 413 | 核对实际请求体与各层上限 |
| 所有大小都 413 | 确认路由、请求构造与实际拒绝层 |
| 响应明确给 Retry-After | 按临时拒绝说明处理,仍先确认提交是否可重试 |
怎样确认有效
允许范围内的文件完成上传且系统中能看到正确结果,超限样本仍按预期被拒绝。收到 HTTP 200 或磁盘出现临时文件,都不能单独证明上传业务成功。
无效时恢复与下一步
管理员按原值恢复本次修改并重新检查、加载与验收;普通使用者保留错误标识联系站点支持。涉及付款或提交申请的表单,先查已有结果,不能盲目重复提交。