适用范围与准备

适用于上传附件或提交表单时明确收到 HTTP 413,包括旧提示 Request Entity Too Large 与现行 Content Too Large。本文区分网站使用者与有权管理服务器的人,不把任意“连接失败”都解释为文件大小限制。

先区分原因

413 表示接收请求的一方拒绝过大的请求内容。限制可能来自 CDN、反向代理或应用;只调整最里面的应用不会自动放宽外层。上传表单还有边界及字段开销,文件大小接近上限也可能超过实际请求体限制。

按顺序操作

  1. 记录失败时间、请求路径、状态码、文件大小及响应中的请求标识,不提供实际附件或认证头。先确认报错是 413,而非下载工具本地限制、磁盘写入失败或 431 请求头过大。
  2. 网站使用者先查该页面明确给出的附件限制;在允许重复测试的入口用小型非敏感文件比较。可以按网站支持的方式压缩或拆分,不能擅自改变正式材料内容或用反复重试绕过限制。
  3. 有权限的管理员按时间和请求标识查每一层访问记录。如果应用根本未收到请求,先找外层拒绝的位置;Server 响应头只是线索,不能单凭它断定由哪一层生成。
  4. 若证据明确指向 NGINX,核对实际命中位置的 client_max_body_size 及继承关系。下面只展示配置项语法;应按业务允许的明确上限,在测试环境定位后修改对应已有 server/location,执行配置检查,再按既有发布流程加载。
  5. 同时核对外层网关与应用上限,测试低于和高于预期限制的样本。上限提高要有容量和业务依据;不设置 0 关闭所有检查,也不因一个上传入口修改全站限制。
仅为 NGINX 配置项示意,不是完整配置或通用推荐值;位置及 8m 必须由业务验收确定。
client_max_body_size 8m;
观察下一步
小样本通过、大样本 413核对实际请求体与各层上限
所有大小都 413确认路由、请求构造与实际拒绝层
响应明确给 Retry-After按临时拒绝说明处理,仍先确认提交是否可重试

怎样确认有效

允许范围内的文件完成上传且系统中能看到正确结果,超限样本仍按预期被拒绝。收到 HTTP 200 或磁盘出现临时文件,都不能单独证明上传业务成功。

无效时恢复与下一步

管理员按原值恢复本次修改并重新检查、加载与验收;普通使用者保留错误标识联系站点支持。涉及付款或提交申请的表单,先查已有结果,不能盲目重复提交。