连接升级

做连接升级时，先不要直接把 http.ResponseWriter 强转成具体实现。真正要判断的是：当前这个 writer 是否提供 http.Hijacker 能力。最小判断是运行时类型断言；如果中间还有日志、压缩或状态记录包装器，则优先用 Go 1.20 引入的 http.NewResponseController，让它沿着包装器的 Unwrap 寻找底层能力。

这两个判断都只回答“当前响应对象能不能接管连接”，并不代表 Hijack 调用一定成功。HTTP/2 连接刻意不支持 Hijacker，包装器也可能没有转发它，所以必须把“不支持”和“接管失败”分开处理。

先判断当前 ResponseWriter 的能力

老而直接的写法是接口断言。ok 为 false 时，不要调用 Hijack；这通常说明当前协议或 writer 包装层没有暴露该能力。

func canHijack(w http.ResponseWriter) bool {
	// 只判断当前对象是否实现了可选接口，不把 ResponseWriter 强转成私有类型。
	_, ok := w.(http.Hijacker)
	return ok
}

标准库文档明确说明：HTTP/1.x 的默认 ResponseWriter 支持 Hijacker，HTTP/2 则有意不支持；任何包装器也可能不支持。因此，接口断言得到的是“这个具体对象现在能否提供方法”，不是对传输协议的猜测。

包装器场景优先用 ResponseController

如果 writer 经过中间件包装，直接断言可能只看到了外层类型。只要包装器提供返回原始 writer 的 Unwrap 方法，就可以交给 ResponseController 处理。它能统一调用 Hijack，不支持时返回与 http.ErrNotSupported 匹配的错误。

func takeOver(w http.ResponseWriter) (net.Conn, *bufio.ReadWriter, error) {
	// Controller 会尝试沿 Unwrap 找到底层的 Hijack 能力。
	controller := http.NewResponseController(w)
	conn, rw, err := controller.Hijack()
	if err != nil {
		// 不支持可能来自 HTTP/2，也可能来自没有转发能力的包装器。
		if errors.Is(err, http.ErrNotSupported) {
			return nil, nil, fmt.Errorf("当前 ResponseWriter 不支持连接升级: %w", err)
		}
		return nil, nil, fmt.Errorf("接管连接失败: %w", err)
	}
	return conn, rw, nil
}

这里的错误判断有两个层次：http.ErrNotSupported 表示能力根本不可用；其它错误表示已经尝试接管，但底层操作失败。不要把所有错误都当成 HTTP/2，也不要仅凭请求头写死协议结论。

接管成功后责任会转移

Hijack 成功后，HTTP 服务库不会再管理这条连接，关闭连接、设置或清除读写 deadline、读写缓冲区都由调用方负责。返回的 *bufio.ReadWriter 还可能带有客户端尚未处理的数据；原始请求体也不能继续使用。

func serveRaw(w http.ResponseWriter) {
	conn, rw, err := takeOver(w)
	if err != nil {
		// 接管前仍由 HTTP handler 负责返回普通错误响应。
		http.Error(w, err.Error(), http.StatusInternalServerError)
		return
	}
	defer conn.Close() // 接管后由应用显式释放底层连接。

	// 这里只写出协议处理的边界，不把缓冲读写误当成普通 ResponseWriter。
	_, _ = rw.WriteString("raw connection ready\n")
	_ = rw.Flush()
}

如果只是需要流式刷新或双向读取，不要为了“连接升级”而强行 Hijack；先确认目标协议真的需要裸连接。若当前连接是 HTTP/2，正确做法通常是改用仍然兼容 HTTP/2 的应用层协议或回到普通 ResponseWriter 语义。

一张表记住判断顺序

总结一下：连接升级的第一步是识别当前 ResponseWriter 的可选能力，而不是猜测底层实现。直接类型断言适合简单场景；包装器链使用 ResponseController 更稳妥；成功接管后立即切换到应用自主管理连接的责任模型。

常见问题

为什么 HTTP/2 下类型断言通常失败？

因为 Go 的 HTTP/2 响应 writer 有意不实现 Hijacker。这不是断言写错，而是该协议模型不允许按 HTTP/1.x 的方式接管连接。

包装器没有 Unwrap 还能用 ResponseController 吗？

不能保证。Controller 只能访问它能找到的底层可选方法；如果包装器没有返回原始 writer，也没有自行转发 Hijack，仍应按 http.ErrNotSupported 处理。

调用 Hijack 后还能继续写 ResponseWriter 吗？

不应继续。接管成功后 HTTP 服务库不再处理该连接，后续应使用返回的 net.Conn 或 bufio.ReadWriter，并由应用负责清理。