实现Golang文件断点续传需利用HTTP的Range请求头与本地文件偏移写入。首先通过net/http发送带Range头的GET请求获取部分数据,服务端返回206状态码表示支持。使用os.OpenFile结合Seek从指定偏移写入文件,避免覆盖。为恢复任务,需持久化记录下载进度(如JSON文件),包含URL、总大小、已下载字节等信息,重启时读取并续传。完成后再删除元数据文件。可选优化:通过HEAD请求获总大小,分块并发下载多个Range至临时文件,最后按序合并提升速度。

实现 Golang 文件下载的断点续传,关键在于利用 HTTP 的 Range 请求头与本地文件的偏移写入。当网络中断或程序退出后,能从上次中断的位置继续下载,避免重复传输已获取的数据,提升效率和用户体验。
使用 Range 请求获取指定字节范围
HTTP 协议支持客户端通过设置 Range: bytes=start-end 请求头,只请求文件的一部分内容。服务端若支持该功能(通常返回状态码 206 Partial Content),则会响应对应的数据片段。
在 Golang 中可使用 net/http 包发起带 Range 头的请求:
client := &http.Client{}
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Range", fmt.Sprintf("bytes=%d-", startByte))
resp, err := client.Do(req)
if err != nil {
// 处理错误
}
defer resp.Body.Close()
if resp.StatusCode == 206 {
// 成功获取部分内容
} else {
// 不支持断点续传(如返回 200)
}
本地文件按偏移写入实现分段保存
下载过程中不能直接覆盖原文件,而应以追加或指定位置写入的方式保存数据。Golang 的 os.OpenFile 配合 Seek 可实现从特定偏移写入。
立即学习“go语言免费学习笔记(深入)”;
示例:打开文件并从指定位置开始写入数据
file, err := os.OpenFile("output.dat", os.O_CREATE|os.O_WRONLY, 0644)
if err != nil {
// 处理错误
}
defer file.Close()
// 跳转到上次中断的位置
_, err = file.Seek(startByte, 0)
if err != nil {
// 处理错误
}
// 写入新下载的数据
io.Copy(file, resp.Body)
记录下载状态以便恢复任务
要支持真正意义上的“续传”,必须持久化记录每个文件的下载进度,比如已下载的字节数、总大小、URL 等信息。可以使用一个简单的 JSON 文件或数据库来保存这些元数据。
常见做法:
- 为每个下载任务创建一个 .dlinfo 文件,存储如下结构:
{ "url": "https://example.com/file.zip", "filename": "file.zip", "total_size": 1024000, "downloaded": 512000 } - 启动下载前先检查是否存在 .dlinfo 文件,读取 downloaded 字段作为起始偏移
- 每次写入成功后更新 downloaded 值
- 下载完成删除 .dlinfo 文件
多协程分块下载与文件合并(可选优化)
为进一步提升速度,可将大文件划分为多个区间,用多个 goroutine 并行下载不同 Range,最后合并成完整文件。
步骤如下:
- 先发送 HEAD 请求获取文件总大小
- 划分 N 个区间,例如每块 10MB
- 每个 goroutine 负责一个 Range 下载,并写入对应的临时文件(如 part_0, part_1)
- 所有部分下载完成后,按顺序合并为最终文件
合并示例:
output, _ := os.Create("final.zip")
defer output.Close()
for i := 0; i < partCount; i++ {
part, _ := os.Open(fmt.Sprintf("part_%d", i))
io.Copy(output, part)
part.Close()
}
基本上就这些。核心是理解 Range 请求机制与文件偏移写入,再辅以状态记录即可实现稳定可靠的断点续传功能。










