Golang下载文件到本地教程

本文深入解析了使用 Go 语言（Golang）安全、高效下载文件到本地的核心要点：纠正“http.Get 返回空内容”的常见误区，强调必须显式读取 resp.Body（推荐 io.Copy 流式写入）、严格校验 StatusCode、及时 defer 关闭 Body 以防连接泄漏；指出默认 http.Get 缺乏超时控制的致命缺陷，倡导自定义带 Timeout 的 http.Client 并谨慎实现重试逻辑；针对大文件场景，明确反对将响应体全量加载进内存，提倡常量内存占用的流式处理，并提供进度追踪与完整性校验（如 SHA256）的实用方案；最后警示 HTTPS 证书验证的陷阱，强调跳过证书校验仅限调试，生产环境应正确配置 RootCAs 而非滥用 InsecureSkipVerify——每一条都是踩坑后的硬核经验，助你写出健壮、可维护、线上可用的文件下载代码。

Go 的 http.Get 下载文件时为啥返回空内容？

因为 http.Get 只发起请求，不自动读取响应体；如果没调用 resp.Body.Read 或 io.Copy，连接可能被复用或提前关闭，文件写入为空。

• 必须显式读取 resp.Body，推荐用 io.Copy 流式写入，避免内存爆掉
• 务必检查 resp.StatusCode，4xx/5xx 响应也会返回非 nil Body，但内容不是目标文件
• 记得 defer resp.Body.Close()，否则连接泄漏，跑几次就卡死

resp, err := http.Get("https://example.com/file.zip")
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()
if resp.StatusCode != 200 {
    log.Fatalf("HTTP %d", resp.StatusCode)
}
out, _ := os.Create("file.zip")
defer out.Close()
io.Copy(out, resp.Body) // 关键：流式复制，不加载全文到内存

用 http.Client 控制超时和重试更靠谱

直接用 http.Get 没法设超时，遇到慢网或挂掉的服务会卡死几十秒；生产环境必须自定义 http.Client。

• Timeout 控制整个请求生命周期（DNS + 连接 + 写请求 + 读响应），建议设 30s 起步
• 别只设 Deadline，它对已建立连接的读写无效；Timeout 更稳妥
• 重试要自己实现——http.Client 默认不重试，且不能盲目重试 500，得判断错误类型（如网络断开才重）

client := &http.Client{
    Timeout: 30 * time.Second,
}
resp, err := client.Get("https://example.com/file.zip")

下载大文件时如何避免 OOM 和进度不可知？

把整个响应体读进 []byte 再写文件，1GB 文件就占 1GB 内存，Go 程序直接被系统 kill。

• 始终用 io.Copy 或分块 io.ReadFull + Write，保持常量内存占用
• 需要进度条？从 resp.ContentLength 获取总大小（注意：可能为 -1，即未知），再用 io.TeeReader 统计已读字节数
• 别依赖 Content-Length 校验完整性，有些服务不返回或返回错误值；下载完建议 sha256.Sum 对比

HTTPS 证书错误、跳过验证的坑在哪？

内网服务或测试环境用自签名证书时，http.DefaultTransport 会直接报 x509: certificate signed by unknown authority。

• 跳过验证仅限调试：替换 Transport.TLSClientConfig.InsecureSkipVerify = true
• 线上绝对不要设 InsecureSkipVerify，否则中间人攻击无感
• 正确做法是把内网 CA 证书加进 tls.Config.RootCAs，用 certpool.AppendCertsFromPEM

证书问题往往卡在 Transport 复用上——一个 client 配错，后续所有请求都失败，不容易定位。

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