登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

Go http.Client 跟随重定向时如何保留认证头

来源:17golang原创

时间:2026-11-17 18:37:47 290浏览 收藏

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 状态失败与读取失败。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>