服务端必须禁用 r.parsemultipartform 自动解析，因 go 的 http.request 在首次访问 r.multipartform 或隐式触发时，默认执行 r.parsemultipartform(32
服务端必须禁用 r.ParseMultipartForm 自动解析
Go 的 http.Request 在首次访问 r.MultipartForm 或隐式触发解析时，会默认执行 r.ParseMultipartForm(32，把整个请求体读进内存或临时文件。这对分片上传是致命的：流被提前消费，<code>r.Body 后续读不到数据，分片内容为空或错位。
必须在 handler 开头第一行调用：r.ParseMultipartForm(0)（传 0 表示禁用自动解析）
- 元信息（如
upload_id、chunk_index）从r.URL.Query().Get("chunk_index")或r.FormValue("upload_id")获取，不要碰r.MultipartForm.Value——它可能为 nil 或尚未就绪 - 分片二进制数据直接从
r.Body读取，用io.CopyN(dst, r.Body, chunkSize)写入磁盘 - 路径建议为
./uploads/{upload_id}/chunk_{index:04d}；并发写同一分片时，打开文件需加os.O_EXCL防覆盖
客户端写文件不能用 os.O_APPEND
os.O_APPEND 是断点续传最隐蔽的坑：它会让所有 Write() 调用强制跳转到文件末尾，完全无视你之前调用的 file.Seek(offset, io.SeekStart)。结果是数据错位、中间填充空白字节，文件损坏。
正确做法是：f, err := os.OpenFile(filename, os.O_WRONLY|os.O_CREATE, 0644)（不加 O_TRUNC，不加 O_APPEND）
打开后立刻：n, err := f.Seek(offset, io.SeekStart)，并检查 n == offset
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 写入前可选调用
f.Truncate(expectedSize)清除尾部脏数据，避免稀疏文件问题 - 并发写同一文件时，
Seek + Write非原子，必须用sync.Mutex包裹，或改用单 goroutine 顺序写 - 不要依赖
fi.Size()作为续传起点——崩溃、截断、部分写入都会让它失效；应结合偏移校验与轻量哈希（如请求头带X-Prev-Chunk-Hash）
状态必须持久化，不能存在内存里
Go 标准库不维护上传状态。map[string]int64 存内存？服务重启就丢；用文件但没加锁？多协程写同一状态文件导致偏移错乱——这不是断点续传，是“重复上传”。
状态至少包含：file_id、uploaded_bytes、total_size、last_modified、status（"uploading"/"completed"/"failed"）
- 推荐存到轻量级持久化介质：SQLite（单机）、Redis（支持过期+原子操作）、或带事务的 PostgreSQL 表
- 每次接收分片前，先查状态确认
uploaded_bytes是否匹配客户端传来的offset，不匹配就返回409 Conflict - 并发上传多个分片时，状态更新和文件写入必须原子：对同一
file_id加分布式锁（RedisSET key value EX 30 NX），或本地用sync.Map+sync.Mutex配合文件名做 key（仅限单进程）
分片校验和合并不能只靠序号
只按 chunk_index 拼接不可靠——网络丢包、重复发送、客户端时钟漂移都可能导致错序或重复。必须引入内容校验机制。
- 客户端上传每个分片时，计算 SHA256 并随请求发送（如
X-Chunk-Hash: a1b2c3...），服务端收到后立刻用crypto/sha256.New()+io.Copy实时校验 - 校验失败返回
400 Bad Request，客户端可重传该分片 - 合并前检查是否收齐所有分片（
len(chunkFiles) == totalChunks），缺一不可；合并时按chunk_index排序，用os.OpenFile(, os.O_WRONLY|os.O_CREATE)+Seek+io.CopyN分批写入目标文件，避免 OOM - 合并完成后清理所有临时分片文件；残留目录超过 24 小时未完成合并的，应定时扫描自动清理
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
