Go 的 http.Client 默认自动跟随 HTTP 3xx 重定向(最多 10 次),可通过设置 CheckRedirect 字段自定义行为:设为 nil 或返回 http.ErrUseLastResponse 可禁用;实现函数可限制次数、校验域名、记录路径;禁用后亦可手动解析 Location 头发起新请求。

Go 的 http.Client 默认会自动跟随 HTTP 3xx 重定向(如 301、302、307、308),无需额外代码。但若需自定义行为(如限制跳转次数、记录跳转路径、禁用自动跳转或手动处理 Location),则需调整 Client.CheckRedirect 字段。
默认行为:自动跟随重定向
标准 http.Get 或 http.DefaultClient.Do 已启用自动跳转,最多 10 次(由 http.DefaultClient.CheckRedirect 控制)。例如:
resp, err := http.Get("https://httpbin.org/redirect/3")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
fmt.Println(resp.StatusCode) // 输出 200(已自动跳完3次)
禁用自动重定向
将 CheckRedirect 设为 nil 或返回 http.ErrUseLastResponse 即可终止跳转,直接返回首次响应:
- 方式一(设为 nil):
client := &http.Client{
CheckRedirect: nil, // 禁用重定向
}
resp, err := client.Get("https://httpbin.org/redirect/1")
// resp.StatusCode == 302,Body 包含原始响应内容
- 方式二(显式拒绝):
client := &http.Client{
CheckRedirect: func(req *http.Request, via []*http.Request) error {
return http.ErrUseLastResponse // 返回此错误即停止跳转
},
}
自定义重定向逻辑
通过实现 CheckRedirect 函数,可控制跳转条件。常见用途包括:
立即学习“go语言免费学习笔记(深入)”;
- 限制最大跳转次数(默认是 10,可改为 3)
- 只允许同域跳转(防止跳到恶意站点)
- 打印每次跳转的 URL 和状态码
- 根据响应头或 body 决定是否继续
var redirectLog []string
client := &http.Client{
CheckRedirect: func(req *http.Request, via []*http.Request) error {
if len(via) >= 3 {
return fmt.Errorf("stopped after 3 redirects")
}
// 记录跳转
lastResp := via[len(via)-1].Response
redirectLog = append(redirectLog, fmt.Sprintf("%d → %s", lastResp.StatusCode, req.URL.String()))
return nil // 继续跳转
},
}
手动解析并发起重定向请求
若禁用自动跳转后想自行处理(如改用 POST 继续、添加认证头等),可读取 Location 头并构造新请求:
client := &http.Client{CheckRedirect: nil}
resp, _ := client.Get("https://httpbin.org/redirect-to?url=/get&status=302")
defer resp.Body.Close()
if resp.StatusCode >= 300 && resp.StatusCode < 400 {
if loc := resp.Header.Get("Location"); loc != "" {
u, _ := url.Parse(loc)
newReq, _ := http.NewRequest("GET", u.String(), nil)
newReq.Header.Set("User-Agent", "my-app/1.0")
finalResp, _ := client.Do(newReq)
defer finalResp.Body.Close()
// 处理 finalResp
}
}
不复杂但容易忽略:重定向时请求方法可能变化(如 302 会把 POST 变成 GET),若需保持方法,应使用 307 或 308 状态码,或手动构造请求。










