// LATEST

Base64 图片上传:10MB 限制为什么不等于 10MB 请求体

代码中的 MAX_FILE_SIZE 是解码后的图片字节上限,不是整个 HTTP 请求体上限。把它和反向代理限制当成同一个数值,会出现后端说支持、代理却提前拒绝的情况。

先算清楚传输膨胀

Base64 每三个原始字节通常编码为四个字符,长度公式是 4 * ceil(n / 3)。默认单图上限是 10 * 1024 * 1024 字节,即 10 MiB。单图编码后约 13.33 MiB;对比接口上传两张接近上限的图片,两段编码合计约 26.67 MiB,还没有计入字段名与 data URI 前缀。

仓库 Nginx 示例却是 client_max_body_size 20M。两张都满足应用单图限制的图片,组成一个请求后仍可能被代理以 413 拦下。这是限额口径不一致,不是图片模型的问题。

raw_bytes = 10 * 1024 * 1024
encoded_bytes = 4 * ((raw_bytes + 2) // 3)
print(encoded_bytes * 2)

内存账单比编码长度更长

路由先拿到完整 JSON 字符串,b64decode 生成字节,再由 OpenCV 解码为像素矩阵。处理中可能同时存在编码文本、文件字节和解码图像。压缩文件只有几 MiB,不代表像素矩阵也只有几 MiB;宽、高、通道数和数据类型才决定主要解码成本。

源码在解码 Base64 之后才检查长度,这不能阻止前面的请求体解析与解码分配。把限额全部放在这一层,无法形成完整资源保护。

更稳妥的约束顺序

建议先限制代理请求体,再限制编码字符串长度,之后校验解码字节,最后校验像素尺寸。四层分别防止传输过大、解码前膨胀、原始文件超额和图像展开超额。大文件场景可以评估 multipart,而不是继续堆叠 JSON 文本。

验证时使用单张边界图、双张边界图和高分辨率压缩图,检查 413 来自代理还是应用。不要为通过请求而无限调大代理限制;应先确定并发预算和像素上限。这里的容量数字来自编码公式,不是运行内存实测。


源码与阅读导航

本文属于「人脸识别服务源码笔记」第 02 篇。依据固定提交 b85ee88017bc 研读,后续版本可能不同。

全部专题与阅读顺序 · 上一篇:一次人脸对比请求如何走完 FastAPI 与 InsightFace · 下一篇:文件头校验里的短路:为什么 RIFF 不足以证明是 WebP

还没有评论

欢迎留下你的观点,保持交流的清晰和友好。

写下评论