如何使用Golang下载网络文件_Golang net/http 下载与保存示例

发布时间 - 2026-01-03 00:00:00    点击率:
用 http.Get 下载文件返回 403 或空内容,主要是因默认 User-Agent 为空被服务器拒绝;需手动设置 User-Agent、检查 StatusCode、用 io.Copy 流式下载并配合临时文件与目录预创建确保健壮性。

http.Get 下载文件时为什么返回 403 或空内容?

很多网站(尤其是 CDN 或静态资源站)会校验 User-Agent,默认的 Go HTTP 客户端请求头里 User-Agent 是空的,导致服务器拒绝响应。直接调用 http.Get(url) 拿到 *http.Response 后,不检查 resp.StatusCode 就写文件,很容易保存一个 0 字节或 HTML 错误页。

实操建议:

立即学习“go语言免费学习笔记(深入)”;

  • 始终用 http.NewRequest 构造请求,并手动设置 User-Agent
  • 检查 resp.StatusCode 是否为 200,非 200 应提前退出并打印错误
  • resp.Body 流式读取,避免内存爆炸(尤其大文件)

如何用 io.Copy 安全保存大文件?

io.Copy 是 Go 标准库推荐的流式复制方式,内部使用固定大小缓冲区(默认 32KB),不会把整个文件加载进内存。但要注意:如果目标路径目录不存在,os.Create 会失败;如果磁盘满或权限不足,io.Copy 返回错误但不会自动清理已写入的碎片文件。

实操建议:

立即学习“go语言免费学习笔记(深入)”;

  • 下载前先用 os.MkdirAll(filepath.Dir(filename), 0755) 确保父目录存在
  • os.CreateTemp 创建临时文件,下载完成再 os.Rename 覆盖目标路径,避免中断后留下损坏文件
  • 务必关闭 dst 文件句柄,否则 Windows 下可能无法删除或重命名

带进度显示的下载要怎么加?

Go 原生没有内置进度回调,得自己包装 resp.Body 实现 io.ReadCloser,并在每次 Read 时更新计数器。注意:不能简单用 Content-Length 判断总大小——有些服务不返回该 header,或用分块传输(chunked encoding)时值为 -1。

实操建议:

立即学习“go语言免费学习笔记(深入)”;

  • 优先检查 resp.Header.Get("Content-Length"),转成 int64;若为空或解析失败,设为 -1 表示未知大小
  • io.TeeReader + 自定义计数器结构体,比手写 Read 方法更简洁
  • 进度打印频率别太高(比如每 1% 或每 1MB 更新一次),避免 IO 和格式化拖慢整体速度
package main

import ( "fmt" "io" "net/http" "os" "path/filepath" "time" )

func downloadFile(url, filename string) error { req, err := http.NewRequest("GET", url, nil) if err != nil { return err } req.Header.Set("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36")

client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
    return err
}
defer resp.Body.Close()

if resp.StatusCode != 200 {
    return fmt.Errorf("HTTP %d: %s", resp.StatusCode, resp.Status)
}

dir := filepath.Dir(filename)
if dir != "." {
    os.MkdirAll(dir, 0755)
}

tmpFile, err := os.CreateTemp(dir, "download-*.tmp")
if err != nil {
    return err
}
defer os.Remove(tmpFile.Name()) // 清理临时文件(仅当失败时)

n, err := io.Copy(tmpFile, resp.Body)
if err != nil {
    return err
}

if err := tmpFile.Close(); err != nil {
    return err
}

if err := os.Rename(tmpFile.Name(), filename); err != nil {
    return err
}

fmt.Printf("Downloaded %s (%d bytes)\n", filename, n)
return nil

}

func main() { err := downloadFile("https://www./link/1e2abba2db0a741cf5f8cebd33605a07", "./downloads/image.jpg") if err != nil { fmt.Printf("Error: %v\n", err) } }

Go 的 HTTP 下载看似简单,但真正稳定落地时,User-Agent、临时文件策略、Content-Length 缺失处理、以及错误路径下的资源清理,这几处最容易被跳过。


# html  # go  # windows  # golang  # app  # 字节  # ai  # win  # apple  # cdn  # 标准库  # 为什么  # if  # Error  # printf  # 结构体  # Length  # nil  # copy  # http  # https  # 临时文件  # 学习笔记  # 流式  # 大文件  # 尤其是  # 句柄  # 设为  # 并在  # 很容易  # 不存在 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 再谈Python中的字符串与字符编码(推荐)  百度浏览器如何管理插件 百度浏览器插件管理方法  详解免费开源的DotNet二维码操作组件ThoughtWorks.QRCode(.NET组件介绍之四)  高防服务器租用首荐平台,企业级优惠套餐快速部署  微信公众帐号开发教程之图文消息全攻略  企业网站制作这些问题要关注  网易LOFTER官网链接 老福特网页版登录地址  微博html5版本怎么弄发超话_超话进入入口及发帖格式要求【教程】  百度浏览器网页无法复制文字怎么办 百度浏览器复制修复  做企业网站制作流程,企业网站制作基本流程有哪些?  Swift中swift中的switch 语句  如何在阿里云域名上完成建站全流程?  免费的流程图制作网站有哪些,2025年教师初级职称申报网上流程?  Laravel任务队列怎么用_Laravel Queues异步处理任务提升应用性能  Laravel怎么连接多个数据库_Laravel多数据库连接配置  儿童网站界面设计图片,中国少年儿童教育网站-怎么去注册?  如何打造高效商业网站?建站目的决定转化率  重庆市网站制作公司,重庆招聘网站哪个好?  浅谈javascript alert和confirm的美化  如何挑选高效建站主机与优质域名?  高性能网站服务器配置指南:安全稳定与高效建站核心方案  Laravel Eloquent关联是什么_Laravel模型一对一与一对多关系精讲  Laravel的HTTP客户端怎么用_Laravel HTTP Client发起API请求教程  rsync同步时出现rsync: failed to set times on “xxxx”: Operation not permitted  Laravel如何使用模型观察者?(Observer代码示例)  Win11怎么修改DNS服务器 Win11设置DNS加速网络【指南】  悟空浏览器如何设置小说背景色_悟空浏览器背景色设置【方法】  如何用VPS主机快速搭建个人网站?  如何在局域网内绑定自建网站域名?  用v-html解决Vue.js渲染中html标签不被解析的问题  Laravel怎么配置.env环境变量_Laravel生产环境敏感数据保护与读取【方法】  Laravel如何自定义分页视图?(Pagination示例)  Python正则表达式进阶教程_复杂匹配与分组替换解析  php打包exe后无法访问网络共享_共享权限设置方法【教程】  百度输入法ai面板怎么关 百度输入法ai面板隐藏技巧  Laravel怎么实现支付功能_Laravel集成支付宝微信支付  猪八戒网站制作视频,开发一个猪八戒网站,大约需要多少?或者自己请程序员,需要什么程序员,多少程序员能完成?  linux top下的 minerd 木马清除方法  EditPlus中的正则表达式实战(6)  如何在云虚拟主机上快速搭建个人网站?  阿里云高弹*务器配置方案|支持分布式架构与多节点部署  Android自定义控件实现温度旋转按钮效果  如何在HTML表单中获取用户输入并用JavaScript动态控制复利计算循环  5种Android数据存储方式汇总  详解Android图表 MPAndroidChart折线图  Laravel如何处理JSON字段的查询和更新_Laravel JSON列操作与查询技巧  深圳防火门网站制作公司,深圳中天明防火门怎么编码?  如何在橙子建站上传落地页?操作指南详解  原生JS实现图片轮播切换效果  弹幕视频网站制作教程下载,弹幕视频网站是什么意思?