计算机网络 / 系统课时

理解范围请求

理解范围请求

范围请求让客户端只获取资源的一部分,而不是每次都从头下载。掌握 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 请求、206 响应与断点续传关系

一个容易忽略的边界是:服务器可以忽略 Range,直接返回 200 OK 和完整资源。因此客户端不能只看自己发了 Range,必须同时检查状态码与 Content-Range 后再决定是追加文件还是覆盖文件。

用本地服务验证范围读取

下面用 Node.js 核心模块启动一个最小范围服务器,不依赖第三方包。保存为 range-server.mjs 后执行 node range-server.mjs;代码只处理单个 bytes=start-end 区间,足够验证协议字段。

js
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"));

启动服务:

bash
node range-server.mjs

预期输出:

text
listening on 8000

另开终端请求第 10~19 字节:

bash
curl -sS -i -H 'Range: bytes=10-19' http://localhost:8000/

预期输出中日期等动态头可能不同,但状态、范围和正文应对应:

text
HTTP/1.1 206 Partial Content
Content-Type: text/plain
Accept-Ranges: bytes
Content-Range: bytes 10-19/37
Content-Length: 10

ABCDEFGHIJ

再请求一个越界区间:

bash
curl -sS -i -H 'Range: bytes=100-120' http://localhost:8000/

预期输出的关键部分是:

text
HTTP/1.1 416 Range Not Satisfiable
Content-Range: bytes */37

断点续传要同时验证资源版本

只凭“从第 N 字节继续”并不安全。如果下载过程中资源被替换,前半段旧内容和后半段新内容可能被拼成损坏文件。客户端应保存强验证器 ETag,恢复时发送 If-Range: "<ETAG>";若验证器仍匹配,服务器返回 206,不匹配时则忽略范围并返回完整的 200。

实际续传可以按三步处理:

  1. 首次下载时保存响应中的强 ETag,同时记录已经完整落盘的字节数,例如 500。
  2. 恢复时发送 Range: bytes=500- 与 If-Range: "<ETAG>"。
  3. 收到 206 且 Content-Range 从 500 开始时才追加;若收到 200,说明资源版本已变化或范围未被采用,应覆盖旧文件并重新下载。

当前演示服务器没有生成 ETag,所以只用于理解范围字段;真实断点续传应由服务器提供稳定的强 ETag,或在适用时使用可靠的 Last-Modified。视频播放器拖动到尚未下载的位置时,本质上也会请求新的字节区间;服务器持续返回正确的 206 与 Content-Range,播放器才能只取目标附近的数据,而不用重新传整段媒体。多区间请求如 bytes=0-9,20-29 还会涉及 multipart/byteranges,基础下载器若不需要并行取片,优先使用单区间更容易正确实现。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解范围请求

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通