go分片下载+断点续传需手动实现：禁用parsemultipartform、从r.body读分片、seek写入、.resume文件持久化状态、严格校验range与content-range。
服务端必须禁用 r.ParseMultipartForm 才能流式接收分片
硬套 r.ParseMultipartForm(32 会把整个请求体读进内存或临时文件，导致分片数据错位、丢失，90% 的失败源于此。<br>必须在 handler 开头立即调用 <code>r.ParseMultipartForm(0)（传 0 表示禁用），否则 r.Body 已被消费，后续 io.CopyN 读不到原始字节流。
元信息（file_id、chunk_index）别从 r.MultipartForm.Value 取——它可能为空或尚未解析完成；应走 URL 查询参数或独立表单字段。
分片数据直接从 r.Body 读取，用 io.CopyN(dst, r.Body, chunkSize) 写入磁盘，路径建议为 ./uploads/{file_id}/chunk_{index:04d}。
写入前用 os.MkdirAll 确保目录存在；并发写同一分片时，打开文件加 os.O_EXCL 防覆盖。
客户端发 Range 请求前必须实测服务端是否真支持
光看响应头有 Accept-Ranges: bytes 不够——Nginx、CDN 常伪造该 header，但实际对 Range 请求返回 200 OK 或 500。
首次下载前，先发试探请求：HEAD /file.zip 或 GET /file.zip 带 Range: bytes=0-1023。
仅当响应码为 206 Partial Content 且 Content-Range 匹配（如 bytes 0-1023/12345678）才启用续传逻辑。
若返回 200，说明服务端不支持，应清空本地文件重下；若返回 416，需用 HEAD 获取真实长度再重试。Range 头格式必须严格为 bytes={offset}-，不能多空格、不能结尾带多余横杠。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
写文件必须用 Seek，os.O_APPEND 是最大陷阱
os.O_APPEND 会让 Write() 忽略所有 Seek()，强制写到末尾，导致数据错位或空白填充。
正确做法：用 os.OpenFile(filename, os.O_WRONLY|os.O_CREATE, 0644) 打开（不加 O_TRUNC，不加 O_APPEND）。
打开后立刻调 f.Seek(offset, io.SeekStart)，并检查返回值是否等于 offset；不等说明文件已被外部修改。
写入前可选调 f.Truncate(expectedSize) 确保文件长度足够，防止稀疏文件问题。
并发写同一文件时，Seek+Write 非原子，必须用 sync.Mutex 包裹，或改用单 goroutine 顺序写。
断点状态必须落地为 .resume 文件，不能只存内存
重启或部署更新后，内存里的偏移量就丢了；也不能直接写进目标文件头部，会污染原始数据。
推荐为 example.zip 创建同名 example.zip.resume，内容为纯文本：offset=12345\nurl=https://...。
每次写入数据前，先用 ioutil.WriteFile 全量覆盖 .resume 文件（避免部分写失败）。
启动续传时，优先读 .resume，验证其中 url 是否与当前任务一致（防止用户换链接但没删 resume 文件）。
下载完成后，删除 .resume 文件，否则下次可能误判为未完成。
http.ParseRange 必须传入真实文件大小，且要处理 ra.End == -1（即 bytes=start- 场景）；客户端收到 206 后必须解析 Content-Range 头校验起始偏移是否匹配本地已写长度——不匹配就得清空重下，否则续传必然错位。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
