// LATEST

临时文件清理要覆盖整条失败路径,不只看 finally 是否存在

服务生成上传目录、输出目录和结果 ZIP;客户端也使用临时 ZIP。审查清理逻辑时,关键不是搜索有没有 finally,而是确认资源创建后,到底从哪一行开始受到保护。

正常路径的清理接力

上传目录由 TemporaryDirectory 管理,路由 finally 关闭上传对象。推理输出的临时目录在 ZIP 打包的 finally 中清理;ZIP 由 FileResponse 背景任务在响应流程结束后删除。客户端临时下载包也在 finally 删除,指定 keep-zip 时再复制到结果目录。

上传目录 → 推理输出目录 → 响应 ZIP → 客户端 ZIP

这些资源分属不同作用域,应分别验证,不能只确认最后一步删除成功。

一个容易漏看的保护空窗

bundle_dir 创建后,代码先写 mask、overlay、CSV 与 metadata,之后才进入 ZIP 打包的 try/finally。若在前面的文件写入或预览生成阶段抛异常,就尚未进入负责清理 bundle_dir 的 finally。

因此从控制流可推导:部分写入失败可能残留输出目录。本文没有人为制造磁盘故障,也没有发现线上实际残留;这里是明确的失败路径审查,而不是事故统计。

响应结束也需要测试

背景清理把 ZIP 生命周期延长到发送结束,这比提前删除合理。但客户端断开、发送异常、进程终止和请求取消的行为不能靠正常路径推测。进程被强制结束时,任何 Python finally 都不能被视为绝对保证。

建议让临时目录上下文从资源创建时就开始覆盖,并为结果文件设置可审计的回收机制。定期回收必须限定专用前缀、绝对目录与保留期,不能对通用临时目录盲目递归删除。

怎样验证才有价值

对掩膜写入、预览、CSV、metadata、ZIP 创建与响应发送分别注入异常,检查目标目录和 ZIP 是否残留。用小型模型替身即可先覆盖大部分生命周期。资源治理最怕“正常完成没有泄漏”被误写成“所有情况下都会自动清理”。


源码与阅读导航

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

全部专题与阅读顺序 · 上一篇:安全解压 ZIP 不只是拒绝 ../:结果包的信任边界 · 下一篇:空 API Key 意味着关闭认证,不能只当成尚未配置

还没有评论

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

写下评论