首页 > Golang > Go教程

Golang实现HTTP文件下载与断点续传教程

时间：2025-10-04 11:36:51 274浏览收藏

在IT行业这个发展更新速度很快的行业，只有不停止的学习，才不会被行业所淘汰。如果你是Golang学习者，那么本文《Golang实现HTTP文件下载与断点续传示例》就很适合你！本篇内容主要包括##content_title##，希望对大家的知识积累有所帮助，助力实战开发！

答案：Go语言通过net/http包实现HTTP文件下载和断点续传，普通下载使用http.Get读取响应体并写入文件；断点续传则通过添加Range请求头指定字节范围，若服务器返回206状态码即支持续传，程序会从本地已下载部分的末尾继续写入，否则根据情况全量重下或报错。示例代码展示了完整下载流程及续传逻辑，并建议确保服务器支持Range请求以实现断点续传功能。

GolangHTTP文件下载与断点续传示例

在Go语言中实现HTTP文件下载以及断点续传功能，关键在于合理使用net/http包并控制请求头中的字节范围。下面是一个实用的示例，展示如何进行普通下载和支持断点续传的分段下载。

普通HTTP文件下载

最基本的文件下载方式是发送GET请求，读取响应体并写入本地文件。

package main

import (
    "io"
    "net/http"
    "os"
)

func downloadFile(url, filename string) error {
    resp, err := http.Get(url)
    if err != nil {
        return err
    }
    defer resp.Body.Close()

    // 创建本地文件
    file, err := os.Create(filename)
    if err != nil {
        return err
    }
    defer file.Close()

    // 将响应体写入文件
    _, err = io.Copy(file, resp.Body)
    return err
}

这个函数会完整下载指定URL的文件并保存为本地文件名。适用于小文件或不需要中断恢复的场景。

支持断点续传的下载

断点续传的核心是利用HTTP的Range头，只请求未下载的部分。同时需要检查服务器是否支持范围请求（返回状态码206）。

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func downloadWithResume(url, filename string) error {
    // 获取已下载文件大小
    fileInfo, err := os.Stat(filename)
    var startByte int64 = 0
    if err == nil {
        startByte = fileInfo.Size()
    }

    // 发起带Range头的请求
    client := &http.Client{}
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Add("Range", fmt.Sprintf("bytes=%d-", startByte))

    resp, err := client.Do(req)
    if err != nil {
        return err
    }
    defer resp.Body.Close()

    // 检查服务器是否支持范围请求
    if resp.StatusCode == 206 {
        // 续传模式：以追加方式打开文件
        file, err := os.OpenFile(filename, os.O_WRONLY|os.O_APPEND, 0644)
        if err != nil {
            return err
        }
        defer file.Close()
        _, err = io.Copy(file, resp.Body)
        return err
    } else if resp.StatusCode == 200 && startByte > 0 {
        // 服务器不支持Range，但本地有部分数据，建议重新开始
        return fmt.Errorf("server does not support range requests, cannot resume")
    } else if resp.StatusCode == 200 {
        // 全量下载（不支持Range）
        file, err := os.Create(filename)
        if err != nil {
            return err
        }
        defer file.Close()
        _, err = io.Copy(file, resp.Body)
        return err
    }

    return fmt.Errorf("unexpected status code: %d", resp.StatusCode)
}

该函数先检查本地是否存在部分文件，若有则从上次结束位置继续下载。如果服务器返回206 Partial Content，说明支持断点续传。

使用示例

调用上述函数进行测试：

func main() {
    url := "https://example.com/largefile.zip"
    filename := "largefile.zip"

    err := downloadWithResume(url, filename)
    if err != nil {
        fmt.Printf("Download failed: %v\n", err)
    } else {
        fmt.Println("Download completed!")
    }
}

你可以手动中断程序后再运行，观察是否能从断点处继续下载。

基本上就这些。注意确保目标服务器支持Range请求（大多数静态文件服务器都支持），否则只能全量重下。实际项目中还可加入进度显示、校验、并发分块等优化。不复杂但容易忽略细节。

今天关于《Golang实现HTTP文件下载与断点续传教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于golang,range,net/http,断点续传,HTTP文件下载的内容请关注golang学习网公众号！

golang range net/http 断点续传 HTTP文件下载