如何在Golang中实现文件分片上传_Golang 文件上传优化方法

2026-01-31 00:00:00 作者：P粉602998670

直接用 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) 但没传索引，导致后端无法识别顺序。必须显式传递分片控制字段：

必传字段：filename（原始名）、chunkIndex（从 0 或 1 开始需前后端约定）、totalChunks、fileHash（整个文件哈希）
后端用 r.FormValue("chunkIndex") 解析，别用 r.PostFormValue——二者在 multipart 场景下行为一致，但前者更明确
如果用 query 参数传控制字段（如 ?chunkIndex=2&totalChunks=10），注意 URL 长度限制，推荐放 body 或 header