客户端使用 http.client 手动构造 multipart。这样减少安装依赖,但协议边界、内容长度和错误处理就需要代码自己负责。
Content-Length 不是文件大小
请求体包括普通表单字段、文件头、图片字节和关闭边界。源码先把字段与头部编码为 bytes,计算它们的字节长度,再加文件 stat 大小与结束边界。使用字节长度很重要:带中文的文件名或字段不能按字符数计算传输长度。
总长度 = 所有字段块 + 文件部分头
+ 文件字节数 + 关闭边界随机 boundary 用来区分各部分,字段布尔值会转为小写 true/false,文件内容以 1 MiB 分块发送。响应 ZIP 同样按块写盘,因此不必把整个结果包先放在一个大 bytes 对象中。
标准库方案的责任边界
HTTPS 路径使用默认 SSL 上下文,保留正常证书验证;URL 的路径与查询会被保留。非 200 响应最多读取 64 KiB 错误体,然后抛出带状态的错误,避免把任意长错误页读入内存。
但成功响应没有显式限制下载总大小,也没有严格验证 Content-Type;如果服务端或代理异常返回了非 ZIP 的 200 页面,错误可能到解压阶段才暴露。可以补充响应类型、长度和结果文件白名单验证。
文件在发送中变化怎么办
长度取自发送前的 stat,之后才打开和读取文件。如果另一程序同时修改图片,声明长度与实际内容就可能不一致。对实验流程应要求输入稳定,或先建立只读快照。这个风险不能靠多加一个超时参数消除。
建议用受控本地服务检查字段值、实际字节数、带中文文件名、非 200 与中断传输。本文只分析请求拼接,未运行网络替身。轻量客户端并不是“代码短就无需测试”,而是把依赖成本换成了协议维护责任。
源码与阅读导航
本文属于「细胞分割工具链笔记」第 11 篇。依据固定提交 fd43764aac23 研读,后续版本可能不同。
- cellpose-segmentation/scripts/segment.py,第 43–49 行
- cellpose-segmentation/scripts/segment.py,第 62–126 行
全部专题与阅读顺序 · 上一篇:metadata.json 能追溯一次实验,但还不等于完全可复现 · 下一篇:安全解压 ZIP 不只是拒绝 ../:结果包的信任边界
还没有评论
欢迎留下你的观点,保持交流的清晰和友好。