计算机网络 / 系统课时
理解范围请求
理解范围请求
范围请求让客户端只获取资源的一部分,而不是每次都从头下载。掌握 Range、206 Partial Content 与 Content-Range 的对应关系后,就能判断断点续传、视频拖动和大文件分片读取是否真的由 HTTP 范围机制完成。
学习目标
- 能写出单区间
Range请求,并解释起止字节是否包含端点。 - 能根据
206、Content-Range、416判断服务器是否正确支持范围请求。 - 能用
If-Range避免资源已变化时把旧文件片段与新文件片段错误拼接。
Range 如何描述字节区间
Range 最常见的单位是 bytes。区间端点是包含式:bytes=0-99 请求前 100 字节;bytes=500- 请求从第 500 字节到文件末尾;bytes=-200 请求最后 200 字节。服务器若支持字节范围,通常还会返回 Accept-Ranges: bytes。
| 请求头 | 含义 | 资源为 1000 字节时的范围 |
|---|---|---|
Range: bytes=0-99 |
指定起止位置 | 0~99,共 100 字节 |
Range: bytes=500- |
从某位置到末尾 | 500~999,共 500 字节 |
Range: bytes=-200 |
取末尾若干字节 | 800~999,共 200 字节 |
不要把第二个数字理解成“长度”。例如 bytes=100-199 的长度是 199 - 100 + 1 = 100 字节,而不是 199 字节。
从请求到 206 响应
服务器满足单个字节范围时,应返回 206 Partial Content,并用 Content-Range 写明实际返回区间与完整资源长度。若客户端请求超出资源边界,例如 1000 字节资源却请求 bytes=1500-1600,典型响应是 416 Range Not Satisfiable,并带 Content-Range: bytes */1000。

一个容易忽略的边界是:服务器可以忽略 Range,直接返回 200 OK 和完整资源。因此客户端不能只看自己发了 Range,必须同时检查状态码与 Content-Range 后再决定是追加文件还是覆盖文件。
用本地服务验证范围读取
下面用 Node.js 核心模块启动一个最小范围服务器,不依赖第三方包。保存为 range-server.mjs 后执行 node range-server.mjs;代码只处理单个 bytes=start-end 区间,足够验证协议字段。
import { createServer } from "node:http";
const data = Buffer.from("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ\n");
createServer((req, res) => {
const range = req.headers.range;
if (!range) {
res.writeHead(200, {
"Content-Type": "text/plain",
"Content-Length": data.length,
"Accept-Ranges": "bytes"
});
return res.end(data);
}
// 本示例只接受一个显式起点的字节区间。
const match = /^bytes=(\d+)-(\d*)$/.exec(range);
if (!match) {
res.writeHead(416, { "Content-Range": `bytes */${data.length}` });
return res.end();
}
const start = Number(match[1]);
const end = match[2] ? Math.min(Number(match[2]), data.length - 1) : data.length - 1;
// 起点越界或区间反向时返回 416。
if (start >= data.length || start > end) {
res.writeHead(416, { "Content-Range": `bytes */${data.length}` });
return res.end();
}
const chunk = data.subarray(start, end + 1);
res.writeHead(206, {
"Content-Type": "text/plain",
"Accept-Ranges": "bytes",
"Content-Range": `bytes ${start}-${end}/${data.length}`,
"Content-Length": chunk.length
});
res.end(chunk);
}).listen(8000, () => console.log("listening on 8000"));启动服务:
node range-server.mjs预期输出:
listening on 8000另开终端请求第 10~19 字节:
curl -sS -i -H 'Range: bytes=10-19' http://localhost:8000/预期输出中日期等动态头可能不同,但状态、范围和正文应对应:
HTTP/1.1 206 Partial Content
Content-Type: text/plain
Accept-Ranges: bytes
Content-Range: bytes 10-19/37
Content-Length: 10
ABCDEFGHIJ再请求一个越界区间:
curl -sS -i -H 'Range: bytes=100-120' http://localhost:8000/预期输出的关键部分是:
HTTP/1.1 416 Range Not Satisfiable
Content-Range: bytes */37断点续传要同时验证资源版本
只凭“从第 N 字节继续”并不安全。如果下载过程中资源被替换,前半段旧内容和后半段新内容可能被拼成损坏文件。客户端应保存强验证器 ETag,恢复时发送 If-Range: "<ETAG>";若验证器仍匹配,服务器返回 206,不匹配时则忽略范围并返回完整的 200。
实际续传可以按三步处理:
- 首次下载时保存响应中的强
ETag,同时记录已经完整落盘的字节数,例如 500。 - 恢复时发送
Range: bytes=500-与If-Range: "<ETAG>"。 - 收到
206且Content-Range从 500 开始时才追加;若收到200,说明资源版本已变化或范围未被采用,应覆盖旧文件并重新下载。
当前演示服务器没有生成 ETag,所以只用于理解范围字段;真实断点续传应由服务器提供稳定的强 ETag,或在适用时使用可靠的 Last-Modified。视频播放器拖动到尚未下载的位置时,本质上也会请求新的字节区间;服务器持续返回正确的 206 与 Content-Range,播放器才能只取目标附近的数据,而不用重新传整段媒体。多区间请求如 bytes=0-9,20-29 还会涉及 multipart/byteranges,基础下载器若不需要并行取片,优先使用单区间更容易正确实现。