go断点续传关键在于服务端响应206、客户端安全seek写入及分片状态防篡改；须用http.servecontent（非servefile），严格校验size/modtime，禁用o_append，用writeat+seek，状态需持久化校验。
Go 实现高性能断点续传文件服务，关键不在“加不加 Range 头”，而在于服务端能否真实响应 206、客户端能否安全 Seek 写入、分片状态是否可查且防篡改。硬套 http.ServeFile 或依赖 os.O_APPEND，90% 会出错。
服务端必须用 http.ServeContent 而非 http.ServeFile
http.ServeFile 看似开箱即用，但它强制 stat 文件路径、无法控制 modtime 和 size、且对权限异常直接返回 403 或 404，根本没法做断点校验。真正可靠的是 http.ServeContent，但必须满足三个硬条件：
-
size必须等于文件真实字节长度（用os.Stat获取，不能估算） -
modtime必须是文件最后修改时间（同样来自os.Stat，不能用time.Now()） -
content参数必须是io.ReadSeeker（如*os.File），不能传bytes.NewReader或加密流——若内容需解密，先写临时文件再os.Open
手动设置 Content-Range 响应头是禁忌：http.ServeContent 会自动计算并写入，重复设置触发 500 Internal Server Error。
客户端发 Range 请求前必须试探验证
只看响应头有 Accept-Ranges: bytes 不够——Nginx、CDN 常伪造它，实际对 Range 请求返回 200 或 500。必须发一次试探请求：
- 用
HEAD /file.zip或GET /file.zip带Range: bytes=0-1023 - 仅当响应码为
206且Content-Range匹配（如bytes 0-1023/12345678）才启用续传 - 若返回
200，说明服务端忽略Range，应清空本地文件走全量下载 - 若返回
416，需用HEAD拿到真实Content-Length再重试
Range 值格式必须严格为 bytes={offset}-（末尾单横杠），不能多空格、不能写成 bytes={offset}- 后跟多余字符。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
写文件必须用 Seek + WriteAt，彻底禁用 os.O_APPEND
os.O_APPEND 是断点续传最大陷阱：它让所有 Write() 忽略 Seek() 结果，强制写到末尾，导致数据错位或空白填充。正确做法是：
- 用
os.OpenFile(filename, os.O_WRONLY|os.O_CREATE, 0644)打开（不加O_APPEND，也不加O_TRUNC） - 立即调用
f.Seek(offset, io.SeekStart)，并检查返回值是否等于offset（不等说明文件被外部修改） - 优先用
f.WriteAt(data, offset)而非f.Write(data)，它不依赖当前偏移量，更安全 - 别用
bufio.Writer包裹，缓冲会破坏Seek和实际写入位置的一致性
并发写同一文件时，Seek+Write 非原子，必须用 sync.Mutex 包裹，或改用单 goroutine 顺序写。
断点状态必须持久化且带校验，不能只靠文件大小
仅靠 os.Stat().Size() 判断续传位置极不可靠——文件可能被截断、篡改或部分写入失败。必须落地轻量状态：
- 服务端接收分片后，把已收
chunk_index存入 Redis SET（如upload:{file_id}:chunks），支持毫秒级查询 - 客户端重试前调用
/api/upload/status?file_id=abc123拉取已传索引列表，只重传缺失项 - 每个分片上传时携带
X-Chunk-Hash（如 SHA256 前 8 字节），服务端收到后实时校验，失败返回400 - 合并阶段不直接
cat所有分片，而是按chunk_index排序后，用io.CopyN分批写入目标文件，避免 OOM
最易被忽略的点：服务端 http.ServeContent 的 size 和 modtime 必须来自 os.Stat，哪怕文件刚写完也要重新 stat；客户端 WriteAt 前没做 Seek 校验，就等于把可靠性交给运气。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
