Echo分片上传需禁用ParseMultipartForm、流式读r.Body、URL取元信息、O_EXCL写文件、Blob.slice分片、Content-Type设为octet-stream、校验206续传、Seek+Mutex写文件、c.File()下载、防路径遍历、持久化状态。
在 Echo 框架里做分片上传和断点续传，不能靠 e.Static 或默认 multipart 解析兜底——它们会吞掉 r.Body、强制缓存、破坏流式读写，90% 的失败都卡在这一步。
服务端必须禁用 ParseMultipartForm 才能读到原始分片数据
Echo 默认不干预 http.Request 行为，但一旦你调了 r.FormValue、r.MultipartForm 或任何触发解析的操作，r.Body 就被消费光了。分片二进制数据直接从 r.Body 流式读取，没得重来。
- handler 开头第一行必须写
r.ParseMultipartForm(0)（传 0 表示禁用），否则后续io.CopyN(dst, r.Body, chunkSize)读不到字节 - 元信息如
file_id、chunk_index要从 URL 查询参数（r.URL.Query().Get("file_id")）或独立表单字段（r.FormValue("chunk_index")）拿，别碰r.MultipartForm - 写入分片文件时用
os.OpenFile(path, os.O_CREATE|os.O_WRONLY|os.O_EXCL, 0644)，加O_EXCL防止并发重复写同一片导致内容错乱
客户端分片上传必须用 Blob.slice，不能 FileReader 全量读
浏览器端用 FileReader.readAsArrayBuffer 把几 GB 文件全读进内存，不是慢的问题，是直接 OOM 或卡死 UI。这不是优化项，是架构硬伤。
- 正确做法：用
file.slice(start, end)返回新Blob，零拷贝、不占 JS 堆内存 - 每个分片发独立 POST，URL 带
upload_id和chunk_index（如/api/upload/abc123/chunk?index=5） - HTTP header 必须设
Content-Type: application/octet-stream；若误设multipart/form-data却没带boundary，服务端直接返回400 Bad Request - 建议加
X-Chunk-Hashheader（如 SHA256 前 8 字节），服务端收到后立刻校验，不落地再算
断点续传依赖服务端真实 Range 支持，不能只看 Accept-Ranges
Nginx、CDN 经常伪造 Accept-Ranges: bytes header，但实际对 Range: bytes=0-1023 返回 200 OK 或 500。客户端不实测就启用续传，必然失败。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
立即学习“go语言免费学习笔记（深入）”；
- 首次下载前，先发试探请求：
HEAD /file.zip或GET /file.zip带Range: bytes=0-1023 - 仅当响应码为
206 Partial Content且Content-Range匹配（如bytes 0-1023/12345678）才启用续传逻辑 - 写文件必须用
f.Seek(offset, io.SeekStart)，os.O_APPEND是最大陷阱——它会让Write()忽略所有Seek()，强制写到末尾，导致空白填充或错位 - 并发写同一文件时，
Seek + Write非原子，必须用sync.Mutex包裹，或改用单 goroutine 顺序写
Echo 中服务大文件下载要用 c.File()，别用 e.Static()
e.Static("/uploads", "uploads") 底层走 http.FileServer 默认逻辑，会尝试把整个文件读进内存再响应，50MB+ 视频大概率触发 ERR_CONNECTION_RESET 或 net::ERR_INCOMPLETE_CHUNKED_ENCODING。
- 必须用
c.File(filepath)（动态路径）或e.File("/video.mp4", "./uploads/video.mp4")（静态注册），二者均调用http.ServeContent，支持流式传输、Accept-Ranges、Content-Length和连接保活 - 务必校验
filename参数防路径遍历：if strings.Contains(filename, "..") || strings.HasPrefix(filename, "/") - 若仍中断，需同步调大 Echo Server 的超时配置：
server.ReadTimeout、server.WriteTimeout，并检查 Nginx/Cloudflare 等中间层超时设置
最易忽略的点是：服务端状态必须持久化。uploadId、已传分片列表、合并进度这些，不能只存在内存或临时 map 里——进程重启就全丢。哪怕只是用本地 JSON 文件或 SQLite 记个 file_id → []int，也比靠客户端“记得传到第几块”靠谱得多。
