当前位置:首页 > 文章列表 > Golang > Go问答 > Go http.Client 跟随重定向时如何保留认证头

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

来源:17golang原创 2026-11-17 18:37:47 0浏览 收藏

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删除
Go netip.Prefix.Masked 怎样规范化带主机位的 CIDRGo netip.Prefix.Masked 怎样规范化带主机位的 CIDR
上一篇
Go netip.Prefix.Masked 怎样规范化带主机位的 CIDR
Go crypto/tls.CurveID.String 怎样把 TLS 曲线编号转成名称
下一篇
Go crypto/tls.CurveID.String 怎样把 TLS 曲线编号转成名称
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1076次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1078次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1238次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1182次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1026次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码