直接用requests.get()下载大文件会失败，因默认无range头致服务端返回完整文件，引发内存溢出或中断重传；需head校验accept-ranges与content-length，stream=true流式下载，range头格式为"bytes=n-"，写入用"ab"模式，辅以元数据文件和文件锁保障续传安全。
为什么直接用 requests.get() 下载大文件会失败
因为默认请求不带 Range 头，服务端返回完整响应体，内存爆掉或网络中断就全得重来。更关键的是，多数 HTTP 服务器（如 Nginx、Apache）对大文件默认开启 Accept-Ranges: bytes，但客户端不主动声明范围，它就只发整个文件——你没问，它就全给。
实操建议：
- 先发一个 HEAD 请求，检查响应头是否有
Accept-Ranges: bytes和Content-Length，没这两个基本没法续传 - 别用
stream=False（默认），必须设stream=True，否则requests会把整个响应体缓存进内存 - 下载前先查本地文件大小：
os.path.getsize(filepath)，这就是下次请求的起始偏移
如何构造合法的 Range 请求头并处理 206 响应
HTTP 断点续传依赖服务端返回状态码 206 Partial Content，而前提是你的 Range 头格式正确且落在文件有效范围内。错写成 Range: bytes=100-（末尾多横杠）或 Range: 100-199（缺 bytes=）都会退化为 200 响应，导致重复写入或覆盖。
实操建议：
- 偏移从 0 开始计数，已下载
n字节，下一次请求头应为：{"Range": f"bytes={n}-"} - 用
response.status_code == 206严格判断是否成功续传；如果是200，说明服务端不认 Range 或配置关闭了分段支持 - 写入时用
open(..., "ab")（append binary），千万别用"wb"，否则清空已有内容
如何安全地更新断点位置并避免并发写入冲突
断点信息不能只靠文件大小推断——比如用户手动删了部分文件、磁盘满导致写入中断但文件大小没变、或者多个进程同时写同一文件，都会让 os.path.getsize() 返回错误偏移。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
实操建议：
- 单独维护一个元数据文件（如
file.zip.part），里面存 JSON：{"offset": 1048576, "url": "https://...", "etag": "abc123"}，每次写入后f.flush()+os.fsync() - 下载前比对服务端
ETag和本地记录，不一致说明源文件已更新，必须清空重下 - 用
os.open(filepath, os.O_RDWR | os.O_CREAT)配合fcntl.lockf()（Linux/macOS）或msvcrt.locking()（Windows）做文件级互斥，防止多进程踩踏
遇到 416 Requested Range Not Satisfiable 怎么办
这个错误不是失败，而是明确告诉你：你报的偏移超出了当前服务端文件长度。常见于服务端文件被删/替换/截断，或你上次记的 offset 比实际 Content-Length 还大。
实操建议：
- 捕获
response.status_code == 416后，立刻发一次无Range的 HEAD 请求，读取最新Content-Length - 如果本地文件大小 > 新的
Content-Length，说明文件已损坏，删掉重来 - 别盲目重试——连续两次 416 就该停，大概率是服务端不支持动态 Range 或路径变了
真正麻烦的从来不是 Range 语法，而是服务端悄悄关闭 Accept-Ranges、CDN 缓存了错误的响应头、或者中间代理强制转成 200——这些都得靠 HEAD + 日志 + 抓包交叉验证，光看 Python 代码看不出问题。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
