如何使用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. 安全可靠的文件写入与校验

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

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

193

查看详情

立即学习“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中文网其它相关文章！