Go语言远程文件如何断点续传 Go语言文件传输控制【迁移】-Golang-PHP中文网

go断点续传核心是客户端精准定位写入位置、服务端真实支持range且双方状态一致；需手动设range头、校验206状态码，避免依赖os.o_append或伪造accept-ranges。

go语言远程文件如何断点续传 go语言文件传输控制【迁移】

Go 语言做远程文件断点续传，核心不是“能不能发请求”，而是客户端能否精准定位写入位置、服务端是否真正支持 Range、双方状态能否一致。硬套 os.O_APPEND 或依赖 r.ParseMultipartForm 默认行为，90% 会失败。

HTTP 断点续传靠的是客户端明确告诉服务端“从第 N 字节开始下载”，这必须通过 Range 请求头实现。Go 的 http.Client 不自动处理，得手动加：

先用 os.Stat 检查本地文件是否存在、大小是多少，offset := fileInfo.Size()
构造请求头：req.Header.Set("Range", fmt.Sprintf("bytes=%d-", offset))，注意格式必须严格为 bytes=12345-，不能多空格、不能写成 bytes=12345--
务必检查响应状态码：只接受 206 Partial Content；若返回 200 OK，说明服务端忽略 Range，应清空本地文件重下
别只看响应头有 Accept-Ranges: bytes——Nginx、CDN 常伪造该 header，但实际不支持；必须靠试探请求验证

服务端若直接调用 r.ParseMultipartForm(32 ，标准库会把整个请求体读进内存或临时文件，破坏流式写入能力，且无法控制落盘路径和时机。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

在 handler 开头立即调用 r.ParseMultipartForm(0)（传 0 表示禁用自动解析），否则 r.Body 已被消费，后续读不到原始字节流
元信息（如 file_id、chunk_index）应从 URL 查询参数或表单字段获取，别依赖 r.MultipartForm.Value——它可能为空或延迟可用
分片数据直接从 r.Body 读取，用 io.CopyN(dst, r.Body, chunkSize) 写入磁盘，路径建议为 ./uploads/{file_id}/chunk_{index:04d}
写入前用 os.MkdirAll 确保目录存在；并发写时加 os.O_EXCL 防止覆盖同一分片文件

os.O_APPEND 是断点续传最大陷阱：它会让 Write() 忽略所有 Seek()，强制写到末尾，导致数据错位或空白填充。

正确打开方式是：os.OpenFile(path, os.O_WRONLY|os.O_CREATE, 0644)，**不加 os.O_APPEND，也不加 os.O_TRUNC**
打开后立即 file.Seek(offset, io.SeekStart)，并检查返回值是否等于 offset；不等说明文件被其他进程修改过
写入前建议用 file.Truncate(expectedSize) 确保文件长度至少为预期值，防止稀疏文件问题
别用 bufio.Writer 包裹 *os.File，缓冲会导致实际写入位置和 Seek 位置不一致

断点信息不能只存在内存里，但也不该塞进数据库或复杂配置——简单即可靠。

最轻量方式：把当前已下载字节数写进同名的 .download.state 文件（如 foo.zip.download.state），内容就一行纯数字
每次启动先 os.Stat 检查状态文件是否存在；存在则读取，并校验原文件大小是否匹配该数值——不匹配说明文件被手动修改过，应清空状态重下
写状态文件必须用 os.WriteFile（原子替换），别用 os.Create + Write，否则中断时留下半截状态
仅靠文件大小判断是否续传不可靠，关键业务建议增加哈希校验：客户端上传前对已传部分计算 SHA256，服务端比对上一块 hash，不一致则返回 416 并附带正确 Content-Range