Go HTTP/2 请求被重置时怎样定位响应状态

Go HTTP/2 请求被重置时，先判断 http.Client.Do 是否返回了 Response，再读取 Response.Body。resp == nil 表示响应头还没有到达，不能声称拿到了 HTTP 状态码；resp != nil 表示状态行和响应头已经收到，即使后续正文读取遇到 stream reset，resp.StatusCode 仍是这次响应的有效状态。

先用 Response 是否存在划分错误层级

Go 的客户端在响应头收到后才把 Response 交给调用方，所以排障第一步不是解析错误字符串，而是记录 resp 是否为空。HTTP/2 的 RST_STREAM 只影响某一条 stream，不能单独替代 HTTP 响应状态。

读取正文时保留状态和部分数据

不要只读取正文而丢掉错误。下面的写法先保存状态，再读取正文；示例输出是日志格式说明，不是某一次真实请求的运行截图。

func readResponse(ctx context.Context, client *http.Client, req *http.Request) error {
    resp, err := client.Do(req)
    if err != nil {
        // 响应头未到达时没有可归属的 HTTP 状态，不要从错误文本猜状态码。
        if resp == nil {
            return fmt.Errorf("响应头未到达: %w", err)
        }
        return fmt.Errorf("状态=%d，但请求阶段有错误: %w", resp.StatusCode, err)
    }
    defer resp.Body.Close() // 无论正文是否读完，都要释放响应体。

    statusCode, status := resp.StatusCode, resp.Status
    body, readErr := io.ReadAll(resp.Body)
    if readErr != nil {
        // ReadAll 可能保留部分 body，状态和已读字节要一起进入诊断记录。
        if errors.Is(readErr, context.Canceled) || errors.Is(readErr, context.DeadlineExceeded) {
            return fmt.Errorf("状态=%d 正文=%d字节 上下文结束: %w", statusCode, len(body), readErr)
        }
        return fmt.Errorf("状态=%d(%s) 正文=%d字节 读取失败: %w", statusCode, status, len(body), readErr)
    }
    fmt.Printf("状态=%d 正文=%d字节\n", statusCode, len(body))
    return nil
}

如果 ReadAll 返回非 nil 错误，len(body) 仍可能大于零，但这些字节只能作为不完整响应使用。日志还可以带上主机、方法、协议版本和 trace ID；Authorization、Cookie 与业务正文不要默认写入日志。

把 stream reset 与普通 HTTP 状态分开

状态码回答“服务端已经发送的响应是什么”，stream reset 错误回答“这条 HTTP/2 流后来怎样结束”。如果先收到 200 OK，再在正文读取时得到 http2: stream error，应记录为“状态 200，正文不完整，流结束异常”，而不是改写成“状态 500”。

标准库 net/http 隐藏了内部 HTTP/2 实现细节，因此应用层优先保存错误类型、错误文本、resp.Proto、状态码和已读长度。明确使用 golang.org/x/net/http2 公开 API 时，才考虑对 http2.StreamError 做结构化判断；普通客户端不必为了一个错误码改成低层连接。

重试前检查幂等性和请求体

重置发生在响应头之前时，客户端无法仅凭错误判断服务端有没有处理完请求；发生在响应头之后时，服务端可能已经返回状态并执行了业务逻辑。因此不要只因为错误看起来像网络问题就重试。

• GET、HEAD 等通常更适合自动重试，但仍要确认服务端没有额外副作用。
• POST、创建订单或支付请求先使用业务幂等键，不要直接重复提交。
• 请求体必须可重放，或能通过 GetBody 重新构造；流式上传通常不能安全复用。
• 限制重试次数和退避时间，并把第一次请求与后续重试关联到同一个 trace 记录。

常见问题

HTTP/2 stream reset 会让 StatusCode 变成 0 吗？

不会自动改写已收到的响应。响应头未到达时通常没有可读取的 Response；响应头已到达时，状态码仍在 resp.StatusCode 中，异常应记录在正文读取结果。

为什么 io.ReadAll 有数据却仍然返回错误？

读取器可以先交付已收到的字节，再报告连接关闭、流重置或上下文取消。部分数据不等于完整正文，业务要根据错误决定是否丢弃或标记为不完整。

可以直接重试所有 stream reset 吗？

不可以。先判断请求是否幂等、正文是否可重放，以及服务端是否可能已经产生副作用；不满足条件时应交给业务幂等机制处理。