直接用 http.FileServer 不适合大文件上传,因其仅服务静态文件,不支持 POST、断点续传及分片解析;需自定义 Handler 处理 multipart 或二进制流,配合 io.Copy 与 os.OpenFile(带 O_APPEND)追加写入分片,并通过哈希去重校验确保完整性。

为什么直接用 http.FileServer 不适合大文件上传
因为 http.FileServer 是为静态文件服务设计的,它不处理 POST 请求体、不支持断点续传、也不解析分片元数据。真要上传大文件,得自己写 http.Handler 解析 multipart/form-data 或自定义二进制流协议。
如何用 io.Copy + os.OpenFile 追加写入分片
客户端按固定大小(如 5MB)切片,每片带参数:filename、chunkIndex、totalChunks。服务端收到后,用 os.O_WRONLY | os.O_CREATE | os.O_APPEND 打开临时文件,避免重复读写全量内容。
-
os.OpenFile必须加os.O_APPEND,否则每次写都覆盖开头 - 分片文件名建议统一为
,而不是用随机名,方便后续合并校验.part001 - 务必检查
chunkIndex是否越界(比如传了chunkIndex=10但totalChunks=5)
file, err := os.OpenFile("upload/"+filename+".part"+fmt.Sprintf("%03d", chunkIndex), os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0644)
if err != nil {
http.Error(w, "无法打开分片文件", http.StatusInternalServerError)
return
}
defer file.Close()
_, err = io.Copy(file, r.Body)
if err != nil {
http.Error(w, "写入分片失败", http.StatusBadRequest)
return
}
怎么判断所有分片已收齐并触发合并
不能只靠计数器,因为网络可能重传同一片。可靠做法是:收到每个分片后,计算其 SHA256 并存入内存 map 或 Redis;等收到 totalChunks 个唯一哈希值,再合并。
- 合并前先用
os.Stat确认每个.part*文件存在且大小非零 - 合并时用
os.Create创建目标文件,再用多个os.Open按序读取各分片,io.Copy流式写入 - 合并完成后立即计算最终文件 SHA256,和客户端传来的
fileHash字段比对
前端传参字段命名和后端解析注意事项
常见错误是前端用 FormData.append("file", blob) 但没传索引,导致后端无法识别顺序。必须显式传递分片控制字段:
立即学习“go语言免费学习笔记(深入)”;
- 必传字段:
filename(原始名)、chunkIndex(从 0 或 1 开始需前后端约定)、totalChunks、fileHash(整个文件哈希) - 后端用
r.FormValue("chunkIndex")解析,别用r.PostFormValue——二者在 multipart 场景下行为一致,但前者更明确 - 如果用 query 参数传控制字段(如
?chunkIndex=2&totalChunks=10),注意 URL 长度限制,推荐放 body 或 header










