用 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 mainimport ( "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.php.cn/link/1e2abba2db0a741cf5f8cebd33605a07", "./downloads/image.jpg") if err != nil { fmt.Printf("Error: %v\n", err) } }
Go 的 HTTP 下载看似简单,但真正稳定落地时,
User-Agent、临时文件策略、Content-Length缺失处理、以及错误路径下的资源清理,这几处最容易被跳过。










