Go http.Client 跟随重定向时如何保留认证头
Go http.Client 会按默认规则转发请求头,但不会无条件把 Authorization 带到任意重定向目标。如果确实需要保留认证头,先明确允许接收认证的目标,再在 CheckRedirect 中设置;不要直接遍历原始 Header 全量复制。对于固定 API,我会优先选择 HTTPS 与精确主机限制,让认证的接收范围在代码里可见。
官方文档:https://pkg.go.dev/net/http#Client
先确定认证头要到达哪个目标
先看初始 URL 与 Location 指向的目标是否属于同一服务。路径迁移、域名迁移和登录跳转是三种不同情况:路径改变通常不需要扩大信任范围;域名迁移需要确认新域名确实是认证接收方;跳转到登录页面则不能仅靠重复发送 Bearer 值解决。
本文只处理 HTTP 重定向期间的头字段复制,不实现 OAuth 登录、令牌刷新或 Cookie 登录态。示例使用保留示例域名,需要替换为自己控制的服务,并通过环境变量传入有相应权限的凭据。
理解默认重定向复制规则
标准库的默认转发会区别对待 Authorization、WWW-Authenticate、Cookie 这类敏感字段:目标是初始域名本身或其子域名时,可以转发;目标是不相关域名时,不转发这些字段。其他普通头通常会继续转发。这个域名关系不能等同于你的业务信任列表。
例如初始服务为 api.example.com,默认域名关系可涵盖其子域名,但不会因此涵盖同级的 login.example.com。不要用字符串包含判断主机关系,否则 api.example.com.attacker.example 也可能被错误接受。自定义 X-API-Key 等业务凭据也不应假定受到与 Authorization 完全相同的默认保护。

设置 CookieJar 后,Cookie 还会受到 Jar 对新 URL 的选择以及响应中 Cookie 更新的影响。本文没有使用 Jar,也不通过复制 Cookie 模拟会话。单纯返回 nil 的 CheckRedirect 只表示允许继续跳转,并不意味着你已经明确指定认证接收范围。
用 CheckRedirect 明确限制目标
下面是一个完整的 GET 示例。每次重定向先删除待发请求里的 Authorization,再检查协议、精确 Host 和 URL 用户信息;符合条件才从初始请求取回认证值。它刻意只接受 api.example.com,不接受子域名、其他主机或显式端口变体。
package main
import (
"fmt"
"io"
"net/http"
"os"
"time"
)
func run() error {
token := os.Getenv("API_TOKEN")
if token == "" { return fmt.Errorf("缺少 API_TOKEN") }
client := &http.Client{
Timeout: 15 * time.Second, // 示例总时限,包含重定向和读取响应
CheckRedirect: func(req *http.Request, via []*http.Request) error {
// 自定义回调接管默认策略,必须自己设置跳转上限。
if len(via) >= 10 { return fmt.Errorf("重定向次数超过限制") }
req.Header.Del("Authorization")
// 只允许固定 HTTPS 主机;Host 比较也限制显式端口。
if req.URL.Scheme != "https" || req.URL.Host != "api.example.com" || req.URL.User != nil {
return http.ErrUseLastResponse
}
if len(via) > 0 {
req.Header.Set("Authorization", via[0].Header.Get("Authorization"))
}
return nil
},
}
// 首次请求也使用固定目标;回调只约束后续重定向。
req, err := http.NewRequest(http.MethodGet, "https://api.example.com/v1/report", nil)
if err != nil { return err }
req.Header.Set("Authorization", "Bearer " + token)
resp, err := client.Do(req)
if err != nil { return err }
defer resp.Body.Close() // ErrUseLastResponse 返回的响应体也由调用方关闭
if resp.StatusCode >= 300 && resp.StatusCode = 300 {
return fmt.Errorf("请求返回 HTTP %d", resp.StatusCode)
}
const limit = 1 limit { return fmt.Errorf("响应超过示例读取上限") }
fmt.Printf("成功读取 %d 字节\n", len(data)) // 不输出认证值或响应正文
return nil
}
func main() {
if err := run(); err != nil {
fmt.Fprintln(os.Stderr, err)
os.Exit(1)
}
}
CheckRedirect 收到的是即将发出的请求,via 保存已经发出的请求,最早的请求位于 via[0]。返回普通错误会让 Do 返回错误;返回 http.ErrUseLastResponse 则停止继续跳转,将最近一次响应交给调用方,且响应体保持未关闭。上例用后者保留被拒绝跳转的 3xx 结果。
默认策略会在一定次数后停止跳转;一旦自己提供回调,就应显式管理次数,不能只返回 nil。示例中的十次限制和十五秒超时是独立约束:次数限制循环跳转,总时限限制整个调用耗时。代码只是展示策略,没有声称实际访问或测量过示例域名。

检查最终响应并整理误区
Do 没有返回错误不等于接口业务成功。允许重定向后拿到的可能是最终 401,也可能是登录页面返回的 200;停止重定向时拿到的可能是 302。需要按状态码和接口约定继续判断,不要只检查 err。上例拒绝非成功状态,限制响应读取长度并关闭响应体。
| 情况 | 应该处理的地方 |
|---|---|
| 同主机路径跳转后仍然 401 | 确认令牌有效性、权限及服务端要求 |
| 不相关域名后认证消失 | 先确认是否应该把认证发送给该域名 |
| 自定义回调无限返回 nil | 增加跳转次数限制与目标判断 |
| 保留头后 POST 仍变为 GET | 检查 301/302/303 方法转换,头字段与方法是两件事 |
| 停止跳转后返回 3xx | 识别策略停止结果并关闭 Body |
为什么没有直接复制全部 Header?
头里可能包含 Cookie、业务密钥或只适用于原目标的信息。应只设置目标服务明确需要的字段,并对每一类凭据定义接收范围。本文代码仅处理 Authorization。
如果必须允许第二个域名怎么办?
把经过确认的协议与精确 Host 组合加入明确的允许列表,同时确认同一个认证值确实适用于它。不要使用任意后缀匹配,也不要因为服务器返回了 Location 就默认信任目标。
这个回调能限制第一次请求吗?
不能。它处理重定向。初始请求必须另外确定可信地址;本文采用固定 HTTPS URL。若地址来自外部输入,应在构建和发送首次请求前应用相应的目标限制。
保留认证头的关键是定义它可以到达哪里。先利用默认规则理解认证为什么被移除,再用小范围的显式策略处理真正需要的跳转,最后区分跳转停止、HTTP 状态失败与读取失败。
Go netip.Prefix.Masked 怎样规范化带主机位的 CIDR
- 上一篇
- Go netip.Prefix.Masked 怎样规范化带主机位的 CIDR
- 下一篇
- Go crypto/tls.CurveID.String 怎样把 TLS 曲线编号转成名称
-
- Golang · Go问答 | 32分钟前 |
- Go os/exec.Cmd.Err 怎样判断命令在启动前就失败
- 125浏览 收藏
-
- Golang · Go问答 | 44分钟前 | 标准库 · 测试 · CI · 工程实践 · Go问答 · Go CI go test -json testing.T.Attr 测试属性 测试元数据
- Go testing.T.Attr 如何向 CI 写入可筛选测试属性
- 315浏览 收藏
-
- Golang · Go问答 | 48分钟前 | go · Go debug/dwarf DWARF dwarf.UnspecifiedType 类型报告
- Go dwarf.UnspecifiedType 怎样在类型报告中单独标记
- 111浏览 收藏
-
- Golang · Go问答 | 51分钟前 | HTTP · go · Go http.Flusher 响应缓冲
- Go http.Flusher 调用后客户端为什么仍看不到数据
- 286浏览 收藏
-
- Golang · Go问答 | 1小时前 |
- Go http.Hijacker 在 HTTP/2 下为什么不能使用
- 218浏览 收藏
-
- Golang · Go问答 | 1小时前 |
- Go math/bits.Add32 怎样处理 32 位整数的进位
- 202浏览 收藏
-
- Golang · Go问答 | 1小时前 |
- Go http.RedirectHandler 怎样返回固定跳转响应
- 363浏览 收藏
-
- Golang · Go问答 | 1小时前 | HTTP · go · HTTP Go ReadRequest
- Go net/http.ReadRequest 怎样解析原始 HTTP 请求
- 495浏览 收藏
-
- Golang · Go问答 | 1小时前 | go · pprof · Go profile runtime/pprof pprof.Lookup
- Go runtime/pprof.Lookup 怎样按名称获取性能 Profile
- 133浏览 收藏
-
- Golang · Go问答 | 1小时前 | go · Go dwarf.EnumType EnumValue
- Go dwarf.EnumType 怎样读取枚举成员名称和值
- 179浏览 收藏
-
- Golang · Go问答 | 2小时前 |
- Go maps.All 怎样遍历映射中的键值
- 292浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1076次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1078次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1238次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1182次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1026次使用
-
- 用Nginx反向代理部署go写的网站。
- 2023-01-17 502浏览
-
- GoLand调式动态执行代码
- 2023-01-13 502浏览
-
- Go gosym.Sym.BaseName 怎样去掉符号的包名与接收者
- 2026-11-17 501浏览
-
- 正则命名捕获组取不到值怎么办
- 2026-11-15 501浏览
-
- Go pprof profile duration 参数如何理解
- 2026-11-14 501浏览

