如何使用Golang实现文件下载功能_支持大文件和断点续传-Golang-PHP中文网

如何使用Golang实现文件下载功能_支持大文件和断点续传

P粉602998670

发布： 2025-12-19 01:33:11

原创

136人浏览过

Go 文件下载需流式读写防内存溢出，支持 Range 断点续传（206响应），用临时文件+重命名保安全，可选校验与超时控制。

如何使用golang实现文件下载功能_支持大文件和断点续传

Go 语言实现文件下载功能，关键在于合理使用 HTTP 客户端、分块读写、支持 Range 请求头，并持久化记录已下载偏移量。大文件和断点续传不是靠“一次性读完再写”，而是靠“边拉边存 + 断点状态管理”。

1. 基础下载：流式读取避免内存溢出

不把整个响应体加载进内存，而是用 io.Copy 或带缓冲的 io.CopyN 直接写入文件：

创建目标文件（os.O_CREATE | os.O_WRONLY | os.O_TRUNC）
发起 GET 请求，检查状态码是否为 200
用 io.Copy(dst, resp.Body) 流式写入，不缓存全文
关闭 resp.Body 和文件句柄（建议用 defer）

2. 支持断点续传：利用 Range 头 + 已下载长度

服务端需支持 Accept-Ranges: bytes（绝大多数静态服务器默认支持）。客户端逻辑如下：

先检查本地文件是否存在；若存在，用 os.Stat 获取已写入字节数 done
构造请求头：req.Header.Set("Range", fmt.Sprintf("bytes=%d-", done))
发送请求，检查响应状态码是否为 206 Partial Content
以 os.O_WRONLY | os.O_APPEND 模式打开文件，从末尾追加写入

3. 安全可靠的文件写入与校验

避免写入中途失败导致文件损坏：

Olli.ai

从web或文件数据快速创建数据可视化

查看详情

立即学习“go语言免费学习笔记（深入）”；

下载时先写入临时文件（如 file.zip.part），完成后再 os.Rename 替换原文件
可选：下载完成后计算 SHA256/MD5 并比对服务端提供的 Content-MD5 或自定义 header
对大文件，建议设置 http.Client.Timeout 和 Transport.MaxIdleConnsPerHost 防连接耗尽

4. 简单封装一个可恢复下载器

核心结构体示例：

type Downloader struct {
    Client *http.Client
    Path   string // 本地保存路径
}

func (d *Downloader) Download(url string) error {
    fi, err := os.Stat(d.Path)
    var done int64 = 0
    if err == nil {
        done = fi.Size()
    }

    req, _ := http.NewRequest("GET", url, nil)
    if done > 0 {
        req.Header.Set("Range", fmt.Sprintf("bytes=%d-", done))
    }

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

    if done == 0 && resp.StatusCode != http.StatusOK {
        return fmt.Errorf("expected 200, got %d", resp.StatusCode)
    }
    if done > 0 && resp.StatusCode != http.StatusPartialContent {
        return fmt.Errorf("expected 206, got %d", resp.StatusCode)
    }

    f, _ := os.OpenFile(d.Path, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
    defer f.Close()

    _, err = io.Copy(f, resp.Body)
    return err
}

登录后复制

以上就是如何使用Golang实现文件下载功能_支持大文件和断点续传的详细内容，更多请关注php中文网其它相关文章！