下载断点续传失败:检查Range与206响应
下载中断后从头开始,或者续传后文件损坏,不能只看带宽。断点续传要求服务端能够返回指定字节范围,客户端还要确认前后拿到的是同一个版本。文件名相同,不代表内容始终相同。
本文用于诊断自己的下载地址,不直接拼接正式文件。若连域名、连接或证书验证都没有通过,先按文件下载报错排查处理;这些问题发生在判断续传能力之前。
先取1KiB,别让检查变成完整下载
选择一个已知大于1KiB、可以公开只读访问的测试文件。限时链接要确认尚未失效,不能把跳到登录页的响应当成文件。先检查curl版本:
curl --version
下面要求curl 8.4.0或更新版本。较早版本在服务端未预先给出长度时,max-filesize可能无法限制实际传输,不直接照用来探测未知大文件。替换示例地址后,只发起一次请求:
curl -q -sS --connect-timeout 5 --max-time 15 \
--range 0-1023 --max-filesize 65536 --limit-rate 64K \
--header 'Accept-Encoding: identity' \
--dump-header - --output /dev/null \
--write-out '\nHTTP=%{http_code} received=%{size_download}\n' \
'https://www.example.com/downloads/sample.bin'
0到1023两端都包含,共1024字节。命令丢弃正文,并设置64KiB体积上限、速率及总时长限制,避免对方忽略Range后把整个大文件传完。若触发上限,curl可能以63退出;结合响应头判断,不把它当作新的网络故障。
命令保留证书验证,不自动跟随跳转,也没有开启自动解压。收到3xx时先核对Location目标;不要为了得到206去跳过证书校验。记录Content-Encoding,若实际返回了另一种编码,就不能直接按本地未编码文件的偏移续接。
206、200和416分别说明什么
| 响应 | 判断方式 |
|---|---|
| 206 Partial Content | 核对Content-Range的起止位置和总长度,并确认收到的正文长度与本次范围相符。 |
| 200 OK | 本次未按范围返回,可能忽略了Range;带If-Range时也可能是版本校验不匹配。不能把整份正文追加到已有分片。 |
| 416 Range Not Satisfiable | 当前范围不能满足,查看Content-Range给出的现有总长度,核对请求偏移和文件版本。 |
例如本次收到以下响应头,表示返回从0开始的1024字节,完整文件当前长度为7340032字节:
HTTP/1.1 206 Partial Content
Content-Range: bytes 0-1023/7340032
Content-Length: 1024
Accept-Ranges: bytes只是支持范围请求的提示,不能保证下一次必定返回206;没有这个字段,也不直接证明不支持。用实际小范围GET判断,比只发HEAD更可靠。
续传时若收到Content-Range: bytes */5000,说明当前表示的总长度是5000字节。若本地已存6000字节,不能继续从6000开始拼接;文件可能已被替换或变短,本地片段也可能属于其他版本。416还可能由无效或过多范围触发,不要为测试构造大量零碎分段。
文件版本变了,续传应当停下来
第一次下载应记录服务端的ETag或Last-Modified。续传使用Range并附上If-Range,可以表达“仍是原版本才给我这一段,否则返回完整内容”。下面仅展示请求头形式,其中ETag必须替换成该文件先前真实返回的值:
Range: bytes=1024-2047
If-Range: "sample-v1"
用于If-Range的ETag必须是强校验器,不能使用带W/前缀的弱ETag。只有没有ETag且Last-Modified满足强校验条件时,才使用它的HTTP日期;不要填写本地文件修改时间。拿不准时交给实现这些校验的下载工具,或重新下载到另一文件,保留原片段待核对。
条件不匹配时返回200完整内容可以是正常行为,不是“服务端把续传弄坏了”。验证第二段仍须保留前面的体积和时间限制,并检查实际状态;不能用shell追加重定向把200正文接到旧文件后面。同一版本也要保持内容编码一致,压缩前后的字节位置不能混用。
定位支持在哪一层丢失
同一文件经过代理后失败时,结合入口与上游日志核对Range、If-Range及响应状态,敏感下载令牌先脱敏。动态下载接口是否实现范围处理、代理是否改写请求头、CDN规则是否适用,都需要实际证据;不为测试临时公开受保护的源站。
Nginx若设置了max_ranges 0,会禁用字节范围支持。查到它后先确认原来的安全与业务用途,只对确实需要下载的路径评估修改;不要直接取消全站限制。仅添加Accept-Ranges响应头,并不会替动态程序实现正确的范围读取。
备份涉及的规则,配置检查通过再按对应服务重载。验收包括首次小范围请求、同版本的下一段,以及版本变化时不会错误拼接。正式完整下载后还应按SHA256核对方法比对可信来源提供的校验值;一次206只能证明这次分段响应,不能证明整个文件完整。