Golang 文件下载如何支持断点续传_Golang Range 请求与文件合并方法-Golang-PHP中文网

Golang 文件下载如何支持断点续传_Golang Range 请求与文件合并方法

P粉602998670

发布： 2025-11-24 22:53:02

原创

526人浏览过

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

golang 文件下载如何支持断点续传_golang 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 文件或数据库来保存这些元数据。

无涯·问知

无涯·问知，是一款基于星环大模型底座，结合个人知识库、企业知识库、法律法规、财经等多种知识源的企业级垂直领域问答产品

142

查看详情

常见做法：

为每个下载任务创建一个 .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 请求机制与文件偏移写入，再辅以状态记录即可实现稳定可靠的断点续传功能。

以上就是Golang 文件下载如何支持断点续传_Golang Range 请求与文件合并方法的详细内容，更多请关注php中文网其它相关文章！