// LATEST

一边上传一边计算 SHA-256:流式保存到底保护了什么

_save_upload 每次读取 1 MiB,在累计字节、检查上限的同时更新 SHA-256 并写入临时文件。这让上传保存逻辑避免一次性把整个文件再读进应用内存。

顺序决定边界行为

每读到一个块,先把长度加到 size,再判断是否超过 MAX_UPLOAD_BYTES,通过后才摘要更新和写盘。恰好等于上限允许保存;超过上限的那一块不会写入目标文件。空文件在循环结束后返回 400,超额返回 413。

读取块 → 累计大小 → 超限判断
      → 更新摘要 → 写入临时文件

路由外层使用 TemporaryDirectory,正常异常退出时会清理上传目录;finally 关闭 UploadFile。这个组合比在每个分支里手工删除文件更容易审计。

流式不等于端到端零缓冲

UploadFile 在进入函数前已经经过框架的 multipart 处理。因此这里只能证明“从 UploadFile 到目标路径”是分块复制,不能证明代理、ASGI 框架或临时存储此前没有接收大量数据。

服务默认允许 256 MiB 文件,但压缩文件体积不是解码像素内存。并发上传也可能先占磁盘,再排队等待推理锁。还需要入口请求体限制、上传超时、磁盘配额与队列上限。

哈希提供身份,不提供匿名化

input_sha256 把输出与输入的精确字节内容关联,便于核对同一次实验。相同像素重新编码后可能得到不同文件哈希,所以它不是“视觉内容相同”的证明,更不是文件来自可信来源的认证。

建议用小文件、恰好上限、超一字节与空文件分别验证状态、磁盘残留和摘要一致性。大文件边界测试可在专用环境缩小测试限额,不必真的发送几百 MiB。

本文依据保存循环分析资源边界,没有对线上端点施压。流式处理的价值在于控制特定阶段的内存与证据链,而不是宣称系统已经不存在大文件风险。


源码与阅读导航

本文属于「细胞分割工具链笔记」第 03 篇。依据固定提交 fd43764aac23 研读,后续版本可能不同。

全部专题与阅读顺序 · 上一篇:三层配置覆盖顺序:模板、本地文件与进程环境谁说了算 · 下一篇:三维数组不一定是三维细胞:图像轴语义不能靠 ndim 猜

还没有评论

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

写下评论