ResponseController Hijack 为何在 HTTP/2 返回不支持

调用 http.NewResponseController(w).Hijack() 后，如果请求走的是 HTTP/2，返回 http.ErrNotSupported 属于预期结果。Go 默认的 HTTP/1.x ResponseWriter 可以暴露 Hijacker，而 HTTP/2 的响应对象不会把多路复用连接交给单个 Handler 接管。修复方向不是强行断言接口，而是先识别能力，再为 HTTP/2 保留响应流处理。

先看错误：它表示能力缺失，不表示请求损坏

ResponseController 是对可选 ResponseWriter 能力的统一探测入口。它支持 Flush、读写截止时间、全双工和 Hijack 等方法，但不会把一个本来没有该能力的响应对象改造成连接控制器。

因此，排查时应把错误拆成两层：第一层是包装器是否隐藏了原始响应对象，第二层是底层协议是否允许接管。HTTP/2 场景通常属于第二层。

为什么 HTTP/2 下没有 Hijacker

HTTP/1.x 中，一个请求对应连接上的顺序处理，Handler 接管后可以读写原始 TCP 字节。HTTP/2 则把多个请求拆成同一连接上的独立流；如果某个 Handler 拿走整条连接，其他流也会失去传输通道，所以 Go 的 HTTP/2 ResponseWriter 有意不实现 Hijacker。

包装器存在时，先确认 Unwrap 链是否完整

中间件常常返回自定义的 ResponseWriter。官方控制器只会在包装器提供 Unwrap() http.ResponseWriter 时继续向里查找；如果包装器没有这个方法，即使底层是 HTTP/1.x，也可能提前得到不支持。

package main

import (
    "errors"
    "net/http"
)

func handle(w http.ResponseWriter, r *http.Request) {
    // 使用统一控制器，避免直接断言自定义包装器一定实现 Hijacker。
    controller := http.NewResponseController(w)
    conn, rw, err := controller.Hijack()
    if err != nil {
        // ErrNotSupported 表示当前协议或包装器没有连接接管能力。
        if errors.Is(err, http.ErrNotSupported) {
            http.Error(w, "当前协议不支持连接接管", http.StatusNotImplemented)
            return
        }
        http.Error(w, "连接接管失败", http.StatusInternalServerError)
        return
    }
    // 接管成功后，连接和缓冲读写器都由当前处理路径负责清理。
    defer conn.Close()
    _, _ = rw.WriteString("raw connection ready\n")
    _ = rw.Flush()
}

示例只表达能力判断和资源责任，不代表 HTTP/2 可以通过包装器绕过协议限制。若包装器的 Unwrap 链最终仍落到 HTTP/2 ResponseWriter，结果依旧是不支持。

正确处理 ErrNotSupported：按协议分流而不是重试

反复调用 Hijack 不会改变 HTTP/2 的能力矩阵。更稳妥的做法是把接管需求变成显式策略：HTTP/1.x 进入原始连接分支；HTTP/2 继续写响应、按需刷新，或者交给支持 HTTP/2 语义的专用协议实现。

如果业务确实依赖原始 TCP 或传统 HTTP/1.1 升级，应该在路由、TLS ALPN、反向代理和客户端协议协商处明确只接受 HTTP/1.1，而不是让 Handler 在 HTTP/2 已建立后再抢救。对于流式输出，通常应保留 HTTP/2 流并配合 Flush；对于双向通信，则选择与 HTTP/2 流模型匹配的协议实现。

用一组小指标验证分流是否有效

这个问题不适合用“重试次数”衡量性能。建议分别记录 HTTP/1.x 的 Hijack 成功率、HTTP/2 的预期降级率、ErrNotSupported 日志量、接管后连接关闭率和请求尾延迟。预期基线是：HTTP/1.x 的成功率取决于包装器是否保留能力；HTTP/2 的不支持率应稳定且可解释，而不是随流量随机抖动。

常见问题

把 ResponseWriter 强制转换成 http.Hijacker 能解决吗？

不能。强制断言只会把能力缺失变成 panic；应使用 ResponseController 或安全的类型判断，并处理 ErrNotSupported。

实现 Unwrap 后 HTTP/2 就能 Hijack 了吗？

不能。Unwrap 只解决包装器隐藏能力的问题，不能改变 HTTP/2 ResponseWriter 本身不支持连接接管的协议边界。

HTTP/2 下要输出实时数据应该怎么办？

继续使用响应流，按实际缓冲策略调用 Flush，并设置写超时和取消处理；不要为了得到 TCP 连接而破坏 HTTP/2 的多路复用。