Go语言Echo框架大文件分片上传与下载断点续传-Golang-PHP中文网

echo分片上传需禁用parsemultipartform、流式读r.body、url取元信息、o_excl写文件、blob.slice分片、content-type设为octet-stream、校验206续传、seek+mutex写文件、c.file()下载、防路径遍历、持久化状态。

go语言echo框架大文件分片上传与下载断点续传

在 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。这不是优化项，是架构硬伤。

Echo框架 5.1.0

Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。

下载

正确做法：用 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-Hash header（如 SHA256 前 8 字节），服务端收到后立刻校验，不落地再算

断点续传依赖服务端真实 Range 支持，不能只看 Accept-Ranges

Nginx、CDN 经常伪造 Accept-Ranges: bytes header，但实际对 Range: bytes=0-1023 返回 200 OK 或 500。客户端不实测就启用续传，必然失败。

首次下载前，先发试探请求：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 等中间层超时设置