Go Hijacker 接管连接后为什么不能继续用 ResponseWriter

调用 http.Hijacker.Hijack() 后，当前请求就不再由 net/http 的 ResponseWriter 负责发送后续响应。连接所有权已经交给处理器，继续执行 w.Write、w.Header() 或依赖服务器自动收尾，通常会得到 http: connection has been hijacked，或者出现看似“写成功”但客户端收不到数据的结果。

先确认 Hijacker 的支持范围

Hijacker 是 ResponseWriter 提供的可选能力，不是所有请求都能强制转换。Go 官方文档明确说明：标准 HTTP/1.x ResponseWriter 支持它，HTTP/2 则有意不支持；中间件包装过的 ResponseWriter 也可能隐藏该接口，所以第一步必须运行时判断。

在接管前完成 ResponseWriter 判断

类型断言失败时不要继续尝试接管；此时 ResponseWriter 仍属于标准 HTTP 流程，可以用 http.Error 返回可理解的状态。如果项目中有多层中间件，Go 1.20 之后也可以让 http.NewResponseController(w) 沿着包装器的 Unwrap 查找底层能力。

func handleUpgrade(w http.ResponseWriter, r *http.Request) {
    // Hijacker 是可选接口，不能假设每个 ResponseWriter 都实现它。
    hj, ok := w.(http.Hijacker)
    if !ok {
        http.Error(w, "hijacking is not supported", http.StatusNotImplemented)
        return
    }

    conn, rw, err := hj.Hijack()
    if err != nil {
        // 接管失败时仍处在 HTTP 处理路径，先返回可诊断的错误。
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    defer conn.Close() // 接管后连接生命周期由当前处理器负责。

    // 这里开始使用返回的缓冲读写器，不再调用 w.Write。
    if _, err := rw.WriteString("raw connection is ready\\r\\n"); err != nil {
        return
    }
    if err := rw.Flush(); err != nil {
        return
    }
}

接管后改用原始连接输出

Hijack 返回的 net.Conn 是连接本身，*bufio.ReadWriter 则承接了服务器尚未消费的读缓冲和写缓冲。成功接管后，服务器不会再替你写 HTTP 头、刷新响应或关闭连接；这些动作需要在新的协议逻辑里明确完成。

因此，正确的边界是“接管前用 ResponseWriter，接管后用 conn/rw”。如果要继续说 HTTP，就要自己写入完整的响应行、头部、空行和正文；如果要切换成 WebSocket、终端或自定义 TCP 协议，也要由接管方完成握手和帧格式。

排查 ErrHijacked 与残留缓冲

看到 ErrHijacked，优先检查是否还有代码路径调用 w.Write 或由统一中间件追加响应。不要把它当成网络抖动重试；它表示 HTTP 服务器已经知道连接被接管。另一个常见坑是忽略返回的 bufio.Reader：Hijack 前已经读入缓冲区的数据仍可能属于当前协议，直接只读 net.Conn 会跳过这些字节。

• 接管前：完成鉴权、必要的 Header 和失败响应。
• 接管成功后：只保留 conn/rw 一套读写入口，并显式 Flush。
• 退出时：关闭连接，避免把关闭责任留给 net/http。

相关问题

HTTP/2 为什么不能直接 Hijack？

HTTP/2 使用帧和多路复用，不能把一个请求简单等同于独占的 HTTP/1.x 字节流，因此标准 ResponseWriter 不提供 Hijacker。

Hijack 后还能设置 Header 吗？

不能把设置 Header 当成服务器会自动发送的保证。接管后应自行写协议数据；若 Header 尚未发送，最好在 Hijack 前完成标准 HTTP 响应所需的决策。

ResponseController 能解决什么问题？

它可以通过包装器的 Unwrap 查找底层的 Hijack 能力，但不会改变接管后的所有权转移规则；成功后仍要使用返回的连接。

判断这类问题只需记住一句话：Hijack 不是“给 ResponseWriter 增加一个高级写入方法”，而是把底层连接交给你。越过这个边界继续调用 ResponseWriter，错误就是预期行为。