Go net/http.Client 怎样处理可选字段

处理 net/http.Client 的可选字段，先记住一个原则：只填写需要改变默认行为的字段。&http.Client{} 本身就是可用客户端；Transport 为 nil 时使用默认传输层，CheckRedirect 为 nil 时采用默认重定向策略，Jar 为 nil 时不会自动维护 Cookie，Timeout 为 0 时不设置客户端总时限。

官方地址：https://pkg.go.dev/net/http

先按请求场景挑选字段

把 Client 当成请求流水线的策略容器，而不是必须一次填满的配置对象。普通的短请求可以只设置 Timeout；需要连接复用或代理/TLS 调整时才提供自定义 Transport；跨请求保存 Cookie 时再设置 Jar；只有业务需要改变跳转规则时才实现 CheckRedirect。

先把零值当作默认策略

这些字段的“可选”不是未初始化就失效，而是由 Client 解释零值。最小客户端可以这样写；它适合没有 Cookie 会话、也不需要自定义重定向的普通请求。

package main

import (
    "fmt"
    "io"
    "net/http"
    "time"
)

func main() {
    client := &http.Client{
        // 只覆盖需要的策略；Transport、CheckRedirect 和 Jar 保持默认零值。
        Timeout: 5 * time.Second,
    }

    req, err := http.NewRequest(http.MethodGet, "https://example.com/", nil)
    if err != nil {
        panic(err)
    }
    resp, err := client.Do(req)
    if err != nil {
        // 网络失败、重定向策略拒绝或超时都会从这里返回。
        panic(err)
    }
    defer resp.Body.Close() // 读取完成后关闭响应体，交还连接复用机会。

    if _, err := io.Copy(io.Discard, resp.Body); err != nil {
        panic(err)
    }
    fmt.Println(resp.Status)
}

零值客户端仍然会跟随 HTTP 重定向，并把重定向次数交给默认策略；它不会因为返回了非 2xx 状态就自动产生 error。调用者仍要读取或关闭 Response.Body，否则底层传输层可能无法复用持久连接。

把可复用 Client 放进请求流水线

Client 和它使用的 Transport 都适合创建后复用，并且可以被多个 goroutine 并发使用。不要在每次请求中重新创建自定义传输层，否则连接池和相关状态无法稳定复用。

package main

import (
    "fmt"
    "net/http"
    "net/http/cookiejar"
    "time"
)

func newClient() (*http.Client, error) {
    jar, err := cookiejar.New(nil)
    if err != nil {
        return nil, fmt.Errorf("创建 Cookie Jar 失败: %w", err)
    }

    return &http.Client{
        // 自定义 Transport 只在需要连接、代理或 TLS 策略时提供。
        Transport: &http.Transport{
            MaxIdleConns: 20,
            IdleConnTimeout: 30 * time.Second,
        },
        // Jar 负责跨请求保存服务端下发的 Cookie。
        Jar: jar,
        // 这个时限覆盖连接、重定向和读取响应体的整体过程。
        Timeout: 10 * time.Second,
    }, nil
}

如果只需要默认传输层，就不要为了“配置完整”而复制 http.DefaultTransport。若提供自定义 Transport，则应把它的生命周期交给可复用的 Client，并根据连接、代理或 TLS 需求逐项配置。

把门禁放在策略字段上

CheckRedirect 是重定向门禁：它在客户端准备跟随跳转前被调用。返回普通错误会让请求失败；返回 http.ErrUseLastResponse 则保留最近一次响应，且这时响应体由调用者负责关闭。下面的策略限制跨主机跳转，并保留一个可解释的错误。

client := &http.Client{
    CheckRedirect: func(req *http.Request, via []*http.Request) error {
        if len(via) == 0 {
            return nil // 第一次请求不是重定向，允许继续。
        }
        if req.URL.Host != via[0].URL.Host {
            return fmt.Errorf("拒绝跨主机重定向到 %s", req.URL.Host)
        }
        if len(via) >= 5 {
            return http.ErrUseLastResponse // 保留最后响应，调用方仍需关闭 Body。
        }
        return nil
    },
    Timeout: 8 * time.Second, // 防止重定向链和响应读取无限等待。
}

如果只想停止跳转而继续处理最近一次响应，使用 ErrUseLastResponse；如果要把它当成失败交给上层，则返回自定义错误。不要把非 2xx 响应和客户端策略错误混为一谈：前者仍然可能伴随一个有效的 Response，后者通常通过 error 返回。

失败处理要区分网络、策略和状态码

使用 Client.Do 时，可以按三个层次处理结果：

1. 返回 error：可能是连接失败、超时、协议错误或 CheckRedirect 拒绝；此时不要把响应状态当成成功结果。
2. error 为 nil：说明客户端完成了这次 HTTP 事务，但不代表业务成功；仍需检查 resp.StatusCode 并关闭响应体。
3. 读取响应体失败：网络可能在响应头之后中断，读取操作本身也必须返回错误，不能只看状态码。

Timeout 是整个客户端请求的总时限，包含连接、重定向和读取响应体；需要更细粒度地控制单次调用时，可以给请求绑定 context.Context。两种时限可以同时存在，较早触发的取消会先结束请求。

用一张表复盘字段选择

日常代码的最小选择通常是“复用一个 Client，加一个合理的 Timeout”；只有业务确实拥有 Cookie 会话、重定向约束或传输层需求时，再逐项加入对应字段。这样排查问题时，触发场景、字段配置、失败门禁和日志复盘也能一一对应。

http.Client 的零值可以直接使用吗？

可以。官方文档把零值 Client 说明为可用客户端，它会使用默认传输层。生产请求仍应考虑设置总时限，并根据接口需求处理响应体。

设置 Timeout 后还需要关闭 Response.Body 吗？

需要。Timeout 负责取消请求，总时限结束后会中断读取；正常返回时，响应体仍由调用者关闭。

Jar 为空时，Request 里的 Cookie 会消失吗？

不会。Jar 为 nil 时，明确写入 Request 的 Cookie 仍可发送，只是 Client 不会自动保存和注入跨请求 Cookie。

技术依据：http.Client 官方文档、Go 官方 Client 实现。