nginx -T | grep client_max_body_size curl -s -X POST $API -F image=@scan_6m.jpg | jq .code
运营上传 6MB 的扫描件，前端先收到 413 Request Entity Too Large，换成 3MB 的又回 400 image size exceeds 4MB，用户以为接口坏了。这类现象通常不是突然出现的，往前翻半天日志能看到苗头。
追下去是这么回事：网关的 client_max_body_size 默认只有 1MB，先拦掉一部分；接口本身还有 4MB 的原图上限，base64 传参又会把体积放大三分之一。两道限制报的错不一样，看着像两个问题。
这次卡住的地方就在「识别图片大小限制」这一环，单独把它拎出来验证，别和其他改动混在同一次发布里。同类问题如果隔一段时间又出现，多半是某个定时任务或重启流程把改动冲掉了。
把这次用到的命令存进笔记，比记住结论有用，换个环境还能照着走。
处理上按这个顺序：网关和接口的上限调成同一个值 避免两次报错；超过上限的图在前端先缩到长边 2500px；改用 multipart 上传 不要 base64 内嵌；入口按文件头判断大小 提前给出提示。
确认没问题再收工，6MB 的图返回明确的超限提示 3MB 的图正常出结果 不再出现 413。