http.ServeFile 不支持断点续传,需手动实现 Range 处理:解析头、校验越界、设置 206 状态码及 Content-Range 等响应头,用 io.CopyN 精确输出字节,并用 curl 测试验证。

用 http.ServeFile 搭配 Range 请求最直接
Go 标准库的 http.ServeFile 默认不支持断点续传,它会忽略客户端发来的 Range 头,始终返回 200 和完整文件。要测断点续传,得自己构造能响应 206 Partial Content 的 handler,而不是依赖 http.ServeFile 或 http.FileServer。
实操建议:
- 写一个手动处理
Range头的 handler:读取请求头中的Range: bytes=100-199,解析起始/结束偏移,用os.Open打开文件,file.Seek定位,再用io.CopyN或io.Copy写出指定字节段 - 必须显式设置状态码为
http.StatusPartialContent(206),并写入Content-Range、Accept-Ranges: bytes、Content-Length等响应头 - 别忘了校验
Range值是否越界(比如bytes=1000-999或超出文件大小),非法时应返回416 Range Not Satisfiable
用 curl -H "Range: bytes=..." 手动触发分段请求
测试时不用写前端或复杂 client,curl 就够用。关键是让请求带合法 Range 头,并检查响应状态码和内容是否匹配预期。
常见错误现象:
立即学习“go语言免费学习笔记(深入)”;
- 返回 200 而不是 206 → 服务端没处理
Range,或用了http.ServeFile - 返回 206 但
Content-Range错误(如写成bytes 0-1023/1024缺少=)→ 客户端可能拒绝解析 - 响应体长度与
Content-Length不符 → TCP 层可能截断,curl报 “transfer closed with outstanding read”
示例命令:
curl -v -H "Range: bytes=512-1023" http://localhost:8080/test.zip
注意加 -v 看完整响应头,确认 Status、Content-Range、Content-Length 三者一致。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
在测试中模拟“中断后重试”需控制连接生命周期
真实断点续传不是只发一次 Range 请求,而是下载中途断开(如网络闪断、client kill),然后用相同 Range 继续。Go 测试里没法真断网,但可以主动关闭连接来模拟。
使用场景:
- 用
net/http/httptest启 server,用http.Client发请求,拿到Response.Body后只读前 N 字节就调body.Close() - 再发一次新请求,带相同
Range(或更大起始值),验证服务端是否仍返回 206 且内容连续 - 别用
httptest.NewUnstartedServer后手动 start —— 它不支持复用底层 listener,无法测连接中断效果;推荐直接用httptest.NewServer+ 显式Close
注意 Content-Length 和 Transfer-Encoding 的冲突
Go 的 http.ResponseWriter 在设置了 Content-Length 后,如果实际写出字节数不匹配,会 panic 报 http: wrote more than the declared Content-Length。而断点续传必须设 Content-Length(因为 206 不允许 chunked 编码)。
容易踩的坑:
- 用
io.Copy写响应体,但文件实际可读字节数小于Range指定长度(比如文件被并发 truncate)→ 写出字节数变少,Content-Length却没同步改 → panic - 忘记在写 body 前调
w.WriteHeader(http.StatusPartialContent)→ Go 会自动写 200,后续再设Content-Length无效 - 用
bufio.Writer包裹ResponseWriter→ 可能延迟写 header,导致Content-Length计算错位
最稳做法:先算好本次要返回的字节数(end - start + 1),设好所有 header 和 status,再用 io.CopyN 精确写出对应字节数。
断点续传的边界逻辑比看起来复杂——起始偏移是否包含、文件末尾对齐、多段 Range 合并、并发修改文件等,测试时容易漏掉这些分支。

















