Golang下载文件方法与技巧分享

本文深入剖析了Go语言中安全、高效下载文件的核心实践，强调避免常见陷阱——如内存溢出（OOM）和连接卡死，指出必须使用`http.Client`设置超时、校验`StatusCode`、并通过`io.Copy`流式写入而非`io.ReadAll`全量加载；同时覆盖带进度显示、断点续传（依赖`Range`头与`Accept-Ranges`判断）、以及健壮的文件名提取与安全清洗（优先解析`Content-Disposition`、防御路径遍历和非法字符），直击生产环境中网络波动、服务端不规范、磁盘异常等真实边界问题，让下载功能真正可靠可用。

用 http.Get 下载文件最简路径

直接发起 GET 请求，读取响应体并写入本地文件是最常用方式。关键不是“能不能”，而是“怎么避免内存爆掉或连接卡死”。

常见错误是把整个响应体 io.ReadAll(resp.Body) 读进内存再写——大文件（比如 500MB）直接 OOM。

• 必须用 io.Copy 流式写入，边读边写
• 务必检查 resp.StatusCode，404 或 502 时 resp.Body 仍可读但内容非目标文件
• 设置超时：用 http.Client{Timeout: 30 * time.Second}，别依赖默认的无限等待

client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Get("https://example.com/file.zip")
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
    log.Fatalf("HTTP %d", resp.StatusCode)
}
out, _ := os.Create("file.zip")
defer out.Close()
io.Copy(out, resp.Body) // 流式写入，安全

带进度显示的下载需手动分块读取

io.Copy 没有回调机制，要显示进度（如 “已下载 32%”），就得自己控制读写循环。

核心是用 io.ReadFull 或 bufio.Reader.Read 分固定大小块（比如 32KB），每写一块就更新进度。

• 缓冲区大小建议 32KB–1MB：太小增加系统调用开销，太大无意义
• 注意最后一块可能不足缓冲区长度，用 n, err := reader.Read(buf) 判断实际读取字节数
• 进度计算基于 Content-Length header；若该 header 缺失（如 chunked 编码），无法预知总大小，只能显示“已下载 XX KB”

buf := make([]byte, 32*1024)
for {
    n, err := resp.Body.Read(buf)
    if n > 0 {
        out.Write(buf[:n])
        downloaded += int64(n)
        pct := float64(downloaded) / float64(totalSize) * 100
        fmt.Printf("\r%.1f%%", pct)
    }
    if err == io.EOF {
        break
    }
    if err != nil {
        log.Fatal(err)
    }
}

下载大文件时必须处理断点续传

网络波动或用户中断后，重新下载整个文件既耗流量又浪费时间。Range 请求头是标准解法，但服务端不一定支持。

判断是否支持续传：先 HEAD 请求，看响应是否有 Accept-Ranges: bytes，且 Content-Length 存在。

• 续传时用 req.Header.Set("Range", "bytes="+strconv.FormatInt(resumePos, 10)+"-")
• 服务端返回 206 Partial Content 表示成功；返回 200 则不支持，需清空已有文件重下
• 本地文件需以 os.O_WRONLY | os.O_CREATE | os.O_APPEND 模式打开，从末尾追加

文件名提取不能只信 URL 路径

URL 中的 filename 可能被篡改、无扩展名、含非法字符，而服务端常在 Content-Disposition header 里提供真实文件名。

优先顺序应为：Content-Disposition → URL path 最后一段 → fallback 到 uuid.NewString() + ".bin"。

• 解析 Content-Disposition 推荐用标准库 mime.ParseMediaType，它能正确处理编码过的中文文件名（filename*=UTF-8''%E6%96%87%E4%BB%B6.pdf）
• Windows 下注意过滤 < > : " / \\ | ? * 等非法字符，Linux 下也要限制长度和控制字符
• 永远对生成的文件名做白名单校验，防止路径遍历（如 ../../etc/passwd）

真正麻烦的不是下载动作本身，而是边界情况：服务端不守规范、网络不可靠、磁盘突然满、用户狂点暂停——这些地方没兜住，下载功能在生产环境就只是个幻觉。

好了，本文到此结束，带大家了解了《Golang下载文件方法与技巧分享》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！