断点下载返回416,是文件没了还是请求范围超出了长度?
下载程序准备续传,服务器却返回416。若直接把它当成404删除本地文件,可能丢掉本来可用的数据;若无条件继续追加,也可能把错误正文写进下载结果。
2026年11月17日,本文先用蜘蛛模拟抓取观察固定416,再在本机用10字节内容比较越界与有效范围。实验文件是公开文字 0123456789,不是生产下载故障。
固定状态不包含文件大小证据
公开样例 https://httpbingo.org/status/416 只返回预设状态。本次工具详情显示416,但没有执行续传、没有本地偏移量,也没有提供某个业务文件的真实长度。

416表示请求中的范围无法满足。对字节范围下载,应保存请求Range、响应Content-Range、当前资源标识和实际文件状态,不能只用这个数字判断资源已删除。
例如文件更新后变短,而客户端还沿用旧文件的偏移,范围就可能超出当前长度。这个原因是排查方向,必须用实际长度和验证器确认,不能仅凭一次416认定发生过文件替换。
从Content-Range读取当前长度
本地内容只有10字节,有效偏移是0到9。请求 Range: bytes=100- 时,演示返回416,并带 Content-Range: bytes */10。

星号表示这份响应没有给出可满足的区间,斜杠后的10说明当前完整表示的长度。它不是“还差10字节”,也不是下载程序已经收到的进度。
另一轮请求 bytes=0-3,返回206、Content-Range: bytes 0-3/10,正文是4字节的 0123。范围两端都包含在内,所以0到3对应4字节,不是3字节。

这些是两次独立请求,不能把第二轮成功写成同一条失败连接被修复。服务器没有更新文件,变化来自请求区间。
用两组固定范围复现
将下面代码保存为 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变成损坏的下载文件。