下载程序准备续传,服务器却返回416。若直接把它当成404删除本地文件,可能丢掉本来可用的数据;若无条件继续追加,也可能把错误正文写进下载结果。

2026年11月17日,本文先用蜘蛛模拟抓取观察固定416,再在本机用10字节内容比较越界与有效范围。实验文件是公开文字 0123456789,不是生产下载故障。

固定状态不包含文件大小证据

公开样例 https://httpbingo.org/status/416 只返回预设状态。本次工具详情显示416,但没有执行续传、没有本地偏移量,也没有提供某个业务文件的真实长度。

工具抓取公开固定416状态;判断下载范围仍需要真实请求的Range和响应里的长度信息
工具抓取公开固定416状态;判断下载范围仍需要真实请求的Range和响应里的长度信息

416表示请求中的范围无法满足。对字节范围下载,应保存请求Range、响应Content-Range、当前资源标识和实际文件状态,不能只用这个数字判断资源已删除。

例如文件更新后变短,而客户端还沿用旧文件的偏移,范围就可能超出当前长度。这个原因是排查方向,必须用实际长度和验证器确认,不能仅凭一次416认定发生过文件替换。

从Content-Range读取当前长度

本地内容只有10字节,有效偏移是0到9。请求 Range: bytes=100- 时,演示返回416,并带 Content-Range: bytes */10。

本地受控请求从100开始,超过10字节资源;416响应的Content-Range为bytes */10
本地受控请求从100开始,超过10字节资源;416响应的Content-Range为bytes */10

星号表示这份响应没有给出可满足的区间,斜杠后的10说明当前完整表示的长度。它不是“还差10字节”,也不是下载程序已经收到的进度。

另一轮请求 bytes=0-3,返回206、Content-Range: bytes 0-3/10,正文是4字节的 0123。范围两端都包含在内,所以0到3对应4字节,不是3字节。

同一本地资源请求0到3,返回206与4字节正文0123,完整表示长度仍为10
同一本地资源请求0到3,返回206与4字节正文0123,完整表示长度仍为10

这些是两次独立请求,不能把第二轮成功写成同一条失败连接被修复。服务器没有更新文件,变化来自请求区间。

用两组固定范围复现

将下面代码保存为 server.py,执行 python3 server.py。它只识别本例两种范围,不是完整Range实现;仅监听本机8765,结束按Ctrl+C停止。

from http.server import BaseHTTPRequestHandler, HTTPServer
class Demo(BaseHTTPRequestHandler):
    def do_GET(self):
        value = self.headers.get('Range')
        ok = value == 'bytes=0-3'
        body = b'0123' if ok else b''
        self.send_response(206 if ok else 416)
        self.send_header('Content-Range', 'bytes 0-3/10' if ok else 'bytes */10')
        self.send_header('Content-Length', str(len(body)))
        self.end_headers(); self.wfile.write(body)
HTTPServer(('127.0.0.1', 8765), Demo).serve_forever()
curl -i -H 'Range: bytes=100-' 'http://127.0.0.1:8765/bytes'
curl -i -H 'Range: bytes=0-3' 'http://127.0.0.1:8765/bytes'

截图使用随机空闲端口,且第一轮额外返回了演示错误JSON;这里用空错误正文简化代码。比较的关键仍是状态、范围与完整长度,不能把错误JSON当成目标文件的一部分追加。

恢复下载前,先确认还是不是同一份文件

把本地已保存字节数与当前完整长度对照。如果偏移恰好等于完整长度,还应校验文件内容和资源版本,再决定是否已经下载完成;长度相同也可能是不同文件,不能直接当作哈希校验通过。

如果资源变更,旧偏移可能已经不适用。按服务约定使用ETag、Last-Modified或If-Range等条件核对表示,必要时从头下载。服务也可能忽略Range而返回200,这时不能把完整正文无条件接到旧文件后面。

网站测速可以补查实际下载入口的响应,但断点续传还要检查客户端怎样处理200、206与416。先把三种分支的文件写入逻辑分开,再测试范围越界,才不容易把一个可解释的416变成损坏的下载文件。