Go http.Client 怎样禁止或限制自动跟随重定向
来源:17golang原创
时间:2026-11-16 10:51:24 127浏览 收藏
Go 的 http.Client 默认会自动跟随 HTTP 重定向。要禁止或限制这件事,不需要改 Transport,直接设置 Client.CheckRedirect 即可:回调返回普通错误会拒绝即将发出的下一跳;返回 http.ErrUseLastResponse 则会把最近一次重定向响应交给调用方,并且返回的错误为 nil。
官方文档:https://pkg.go.dev/net/http#Client.CheckRedirect
如果你只想观察 3xx 状态码和 Location,优先返回http.ErrUseLastResponse;如果要把重定向视为调用失败,返回自定义错误更合适。两种写法的最大区别是响应体是否仍可读取,以及Do最终是否返回错误。
- 默认行为:
CheckRedirect为nil时,客户端会继续跟随,默认最多连续请求 10 次。 - 完全禁止:回调返回普通错误,下一跳不会发送,错误通常会被包装为
*url.Error。 - 保留 3xx:回调返回
http.ErrUseLastResponse,最近响应与未关闭的 Body 一起返回,错误为nil。 - 条件限制:回调参数
req是即将发送的请求,via保存已经发出的请求,适合做域名和链长判断。
先看清 http.Client 的默认重定向策略
http.Client 比底层 RoundTripper 高一层,除了发送请求,还负责 Cookie 和重定向等策略。CheckRedirect 为空并不等于“禁止跳转”,而是采用默认策略。因此下面这种写法仍然会自动跟随服务端返回的 301、302、303、307 或 308,直到到达最终响应或超过默认连续次数。
client := &http.Client{}
// CheckRedirect 为 nil 时使用 net/http 的默认重定向策略。
resp, err := client.Get(targetURL)
if err != nil {
// 网络错误、协议错误或重定向策略错误都会从这里返回。
return err
}
defer resp.Body.Close()
// 非 2xx 状态本身不会自动变成 err,需要单独查看 StatusCode。
fmt.Println(resp.StatusCode, resp.Request.URL)
所以“不要自动跳转”不能靠检查最终状态码补救,因为请求可能已经访问过不希望访问的目标。策略应该在下一跳发出前,通过 CheckRedirect 作决定。

完全禁止自动跟随:返回普通错误
如果业务把任何重定向都视为异常,可以在回调中返回自定义错误。回调执行在下一次请求发出之前,返回错误后不会发送参数里的 req。调用 Do 时,通常能拿到一个已被关闭 Body 的上一响应和包装后的错误;生产代码应优先判断错误,再按需要记录响应状态。
var errRedirectBlocked = errors.New("redirect blocked by client policy")
client := &http.Client{
CheckRedirect: func(req *http.Request, via []*http.Request) error {
// req 是尚未发送的下一跳;返回错误即可阻止这一次跳转。
return errRedirectBlocked
},
}
resp, err := client.Do(request)
if err != nil {
// Client.Do 通常返回 *url.Error,原始策略错误可用 errors.Is 判断。
if errors.Is(err, errRedirectBlocked) {
return fmt.Errorf("拒绝跳转:%w", err)
}
return err
}
defer resp.Body.Close()
// 只有 err 为 nil 时,才在这里读取当前响应体。
return nil
这个模式适合不允许跨站跳转、只允许固定入口 URL,或希望把 3xx 统一交给上层重试/告警的场景。要注意它和“返回最后一次响应”不是一回事:普通错误会让调用方进入错误分支,而不是把 3xx 当作一次正常响应继续处理。
只查看当前 3xx:使用 http.ErrUseLastResponse
很多客户端其实需要的是重定向响应本身,例如读取 Location、记录服务端的迁移目标,或者由业务层决定是否跳转。这时回调应返回标准哨兵错误 http.ErrUseLastResponse。它会阻止下一跳,返回最近响应,同时错误为 nil;这个响应的 Body 保持未关闭,调用方必须负责关闭。
client := &http.Client{
CheckRedirect: func(req *http.Request, via []*http.Request) error {
// 不发送下一跳,但把当前 3xx 响应交给业务层。
return http.ErrUseLastResponse
},
}
resp, err := client.Do(request)
if err != nil {
return err
}
defer resp.Body.Close()
// ErrUseLastResponse 让这里可以正常读取 3xx 的 Location。
if resp.StatusCode >= 300 && resp.StatusCode
别把 ErrUseLastResponse 继续向上当作普通失败处理:它是控制重定向流程的特殊返回值,不是一个需要由 errors.Is(err, http.ErrUseLastResponse) 捕获的最终错误。

限制跟随次数和目标地址
“禁止所有跳转”通常过于严格,更常见的需求是只允许同一站点内跳转,或最多跟随一跳。回调中的 via 按最早请求到最近请求保存历史,长度可以作为已经发生的跳转链判断依据;req.URL 则是将要访问的地址。
client := &http.Client{
CheckRedirect: func(req *http.Request, via []*http.Request) error {
// 只允许最多一次跳转;初始请求不计入 via 的跳转链。
if len(via) >= 1 {
return http.ErrUseLastResponse
}
// 只允许跳到预先信任的主机,避免策略被跨站 Location 绕过。
if req.URL.Hostname() != "api.example.com" {
return fmt.Errorf("不允许跳转到 %s", req.URL.Host)
}
return nil
},
}
resp, err := client.Do(request)
if err != nil {
return err
}
defer resp.Body.Close()
return nil
如果只允许同源跳转,实际项目通常还应比较初始请求与目标请求的 scheme、hostname 和必要的端口,而不是只写一个字符串白名单。涉及认证信息时,也不要因为客户端会处理部分敏感 Header,就把任意跨站重定向当成安全的;更稳妥的做法是把目标范围写成明确策略。
最容易忽略的两个返回值边界
| 回调返回值 | 下一跳 | 最终 err | 响应体处理 |
|---|---|---|---|
nil | 继续发送 | 通常为 nil | 最终响应由调用方关闭 |
| 普通 error | 不发送 | 返回包装后的策略错误 | 上一响应 Body 已关闭 |
http.ErrUseLastResponse | 不发送 | 为 nil | 最近响应 Body 未关闭,由调用方关闭 |
第一,Do 返回非 nil 响应时不能机械地认为“有响应就一定要读取并关闭”:普通策略错误对应的上一响应 Body 已由客户端关闭;第二,只要 err == nil 且拿到响应,调用方仍应关闭 Body,尤其是 ErrUseLastResponse 的场景,否则会影响连接复用。
结论:按业务目的选择写法
要完全禁止自动跟随,CheckRedirect 返回普通错误;要保留 3xx 响应并读取 Location,返回 http.ErrUseLastResponse;要做有限跟随,则在回调里检查 via 和 req.URL 后决定返回 nil 还是拒绝。这样既能控制访问范围,也能让调用方准确区分“策略拒绝”和“拿到一条可处理的重定向响应”。
常见问题
把 CheckRedirect 设为 nil 能禁止跳转吗?
不能。nil 表示使用默认策略,客户端仍会自动跟随重定向,并在连续请求达到默认上限时停止。
为什么返回 ErrUseLastResponse 后 err 是 nil?
这是 net/http 为“停止跟随但保留最近响应”定义的特殊控制分支。它让 3xx 可以像普通响应一样被调用方读取。
普通错误和 ErrUseLastResponse 都不发下一跳吗?
是的,但结果不同:普通错误会进入错误分支,上一响应 Body 已关闭;ErrUseLastResponse 返回 nil 错误,最近响应 Body 仍需调用方关闭。
via 的长度能直接当作重定向次数吗?
它适合做重定向链判断,但策略仍应结合目标 URL 和你的业务边界。不要只依赖次数放行不受信任的跨站目标。
-
502 收藏
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
462 收藏
-
316 收藏
-
168 收藏
-
404 收藏
-
425 收藏
-
366 收藏
-
121 收藏
-
346 收藏
-
390 收藏
-
313 收藏
-
496 收藏
-
322 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习