服务生成上传目录、输出目录和结果 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 研读,后续版本可能不同。
- cellpose-server/app.py,第 209–258 行
- cellpose-server/app.py,第 309–340 行
- cellpose-segmentation/scripts/segment.py,第 191–221 行
全部专题与阅读顺序 · 上一篇:安全解压 ZIP 不只是拒绝 ../:结果包的信任边界 · 下一篇:空 API Key 意味着关闭认证,不能只当成尚未配置
还没有评论
欢迎留下你的观点,保持交流的清晰和友好。