go 1.16+ http.fileserver 支持 range 需满足三条件：底层 http.file 实现 io.seeker、禁用 gzip 中间件、路由不篡改原始路径；实测须返回 206 和正确 content-range；手动实现应使用 http.servecontent 而非手写逻辑。
Go 1.16+ 的 http.FileServer 默认就支持 Range，但得满足三个条件
不是所有 http.FileServer 都能返回 206 Partial Content，它只在底层文件系统返回的 http.File 实现了 io.Seeker 时才生效。Go 1.16+ 的 http.Dir 已内置该能力，但你若用了自定义 http.FileSystem（比如从 zip 或内存读取），就得自己确保 Open() 返回的对象同时满足：http.File + io.Seeker。
- 用
http.Dir("/static")直接包装，不用改代码 —— 它已支持Range - 别在中间加 gzip 压缩中间件：
gzip会 wrapResponseWriter，破坏http.ServeContent对Seek和响应头的控制，导致始终返回200 - 路由不能重写路径后丢掉原始文件名：
http.FileServer依赖req.URL.Path映射到文件系统路径，若用http.StripPrefix错了长度，或用正则替换路径，可能导致Stat()失败，进而跳过Range处理逻辑
验证服务端是否真支持 Range：别信 Accept-Ranges: bytes，要看状态码
Accept-Ranges: bytes 响应头常被 Nginx、CDN 伪造，实际发 Range 请求却返回 200 或 500。唯一可靠方式是实测：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 用
curl -I -H "Range: bytes=0-1023" http://localhost:8080/big.zip - 必须同时满足：
HTTP/1.1 206 Partial Content+Content-Range: bytes 0-1023/12345678 - 如果返回
200 OK，说明服务端忽略Range—— 检查是否启用了 gzip、是否用了http.ServeFile（它不支持）、或文件系统不支持Seek - 如果返回
416 Requested Range Not Satisfiable，说明支持Range，只是范围越界（比如请求bytes=9999999-但文件只有 1MB）
手动实现 Range handler 时，http.ServeContent 是唯一安全选择
别手写 io.CopyN + Seek + 状态码设置 —— 容易漏掉 ETag 计算、If-Range 校验、Last-Modified 同步等细节，且一不小心就会 panic：“http: superfluous response.WriteHeader call”。http.ServeContent 内部已完整处理所有边界情况。
- 必须先调
f.Stat()获取os.FileInfo，传给http.ServeContent的modtime参数，否则缓存和 ETag 行为异常 - 必须用
f（*os.File）本身，不能用bufio.NewReader(f)包裹 ——bufio.Reader会缓冲并破坏Seek精度 - 千万别在
http.ServeContent前写任何响应体，包括w.Write([]byte{})，否则直接 panic - 示例关键行：
http.ServeContent(w, r, stat.Name(), stat.ModTime(), f)—— 第四个参数是modtime，不是time.Now()
并发下载时，file.WriteAt 是唯一线程安全的写入方式
多个 goroutine 并发写同一个文件，file.Write() 会因共享文件偏移量而错乱；os.O_APPEND 更危险 —— 它强制所有写入追加到末尾，无视 Seek 结果，导致数据覆盖或空洞。
- 主文件必须用
os.OpenFile(path, os.O_CREATE|os.O_RDWR, 0644)打开一次，所有 goroutine 共享该*os.File - 每个 goroutine 调用
file.WriteAt(data, int64(start))，start 是该分块起始字节偏移 - 别用
file.Seek(start, io.SeekStart); file.Write(data)—— 在并发下，Seek和Write不是原子操作，中间可能被其他 goroutine 修改偏移量 - Windows 下
WriteAt非原子，但对下载合并影响极小；Linux/macOS 完全可靠
Range ≠ 客户端能稳定续传。客户端必须校验每次响应的 Content-Range 头中起始偏移是否等于预期值 —— 如果服务端文件被替换或 CDN 缓存污染，bytes 1024-2047/10000 可能变成 bytes 0-1023/5000，续传就会错位。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
