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

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 作决定。

Go http.Client 从初始请求到重定向策略回调的关系说明图
图1:Go http.Client 处理初始响应、下一跳请求与 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) 捕获的最终错误。

普通错误与 http.ErrUseLastResponse 的响应体和错误返回差异图
图2:普通拒绝与 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 和你的业务边界。不要只依赖次数放行不受信任的跨站目标。

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