如何在 Go 中使用 net/http.Hijacker 接管 HTTP 连接-Golang-PHP中文网

net/http.hijacker是go标准库中用于劫持http连接的接口，必须在需绕过http协议栈直接操作底层tcp连接时使用，如websocket升级、https代理隧道、自定义二进制协议等；调用前响应未写出，且http/2环境下不可用。

如何在 go 中使用 net/http.hijacker 接管 http 连接

net/http.Hijacker 是什么，什么时候必须用它

net/http.Hijacker 是 Go 标准库中一个接口，允许你从 http.Server 的正常 HTTP 处理流程中“抢走”底层的 net.Conn。它不是用来做普通 REST API 的——一旦调用 Hijack()，你就不能再写入 http.ResponseWriter，也不能依赖标准的 header、状态码、chunked encoding 等机制。

典型使用场景包括：实现 WebSocket 升级（虽然更推荐用 gorilla/websocket）、自定义二进制协议桥接、长连接隧道、或需要直接读写 TCP 流的代理逻辑。

注意：Hijack() 要求响应尚未写出（即还没调用过 WriteHeader() 或 Write()），否则会返回 http.ErrHijacked 错误。

如何安全调用 Hijack() 并避免 panic

直接对任意 http.ResponseWriter 类型断言 http.Hijacker 可能失败——比如在某些中间件（如 httputil.NewSingleHostReverseProxy）或测试用的 httptest.ResponseRecorder 中，该接口未被实现。

正确做法是先判断再调用：

hj, ok := w.(http.Hijacker)
if !ok {
    http.Error(w, "webserver doesn't support hijacking", http.StatusInternalServerError)
    return
}
conn, bufrw, err := hj.Hijack()
if err != nil {
    log.Printf("Hijack failed: %v", err)
    return
}
// 此时 conn 是裸 net.Conn，bufrw 是 *bufio.ReadWriter
// 你必须自己管理读写，且不能复用 w

常见错误：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

忘记检查 ok 就直接断言，导致 panic
调用 Hijack() 前已向 w 写入数据（哪怕只是 w.WriteHeader(200)）
调用后仍尝试用 w.Write()，会触发 http.ErrHijacked

接管后怎么读写，为什么必须用 bufrw 而非 conn

Hijack() 返回的 bufrw *bufio.ReadWriter 已预填充了请求 body 中尚未被 http.Request.Body 消费的字节（比如你调用了 r.ParseForm() 但没读完原始流）。如果直接用 conn.Read()，会跳过这部分残留数据，造成协议错位。

实操建议：

用 bufrw.Reader 继续读取剩余请求数据（例如 WebSocket Upgrade 请求头之后的 payload）
用 bufrw.Writer 发送响应（如 101 Switching Protocols）和后续二进制帧
务必在完成交互后显式调用 conn.Close() —— bufrw 不会自动关连接
若需并发读写，注意 bufio.ReadWriter 非线程安全，应加锁或改用 conn 自带的 SetReadDeadline/SetWriteDeadline