当前位置：首页 > 文章列表 > Golang > Go问答 > Go http.ResponseController 如何判断连接能力：Flush、Hijack 与失败回退

Go http.ResponseController 如何判断连接能力：Flush、Hijack 与失败回退

来源：17golang原创 2026-08-27 18:37:54 0浏览收藏

做流式 HTTP 响应时，能不能刷新缓冲区、能不能接管底层连接，不应该靠猜 ResponseWriter 的具体类型。Go 的 http.ResponseController 可以从当前响应对象探测这些能力：支持就调用 Flush 或 Hijack，不支持时收到 ErrNotSupported，再走普通响应或明确报错的回退路径。

ResponseController 解决的是“当前 ResponseWriter 有没有这项能力”的探测问题，不会凭空给响应增加能力；ErrNotSupported 是能力边界，不应被当成网络故障重试。

要点速览

Flush 适合把已经写入的响应尽快推给客户端，但前提是当前响应链支持刷新。
Hijack 会把连接控制权交给调用方，调用前要确认响应头和普通 HTTP 写入已经结束。
能力不支持时应识别 ErrNotSupported，选择普通响应、关闭流式模式或返回清晰错误。
一旦发生 Hijack，后续读写由底层连接负责，不能继续把它当作普通 ResponseWriter 使用。

先看一个流式响应的判断现场

一个导出接口会先写出几行进度，再在任务结束时返回结果。开发时最容易出现的写法是把 w.(http.Flusher) 当成所有场景的固定入口，或者直接假设 Hijack 一定可用。经过中间件包装、测试响应记录器或特殊协议适配后，ResponseWriter 的能力可能已经变化。

func stream(w http.ResponseWriter, r *http.Request) {
    controller := http.NewResponseController(w)
    if err := controller.Flush(); err != nil {
        if errors.Is(err, http.ErrNotSupported) {
            http.Error(w, "当前响应不支持流式刷新", http.StatusNotImplemented)
            return
        }
        http.Error(w, "刷新响应失败", http.StatusBadGateway)
        return
    }
    _, _ = io.WriteString(w, "data: ready\n\n")
}

这里先探测 Flush，再决定是否进入流式路径。要注意顺序：如果已经把大量普通正文写入缓冲区，失败后的状态码和错误正文未必还能按预期修改。

ResponseController 先探测 Flush 能力，遇到 ErrNotSupported 后回退普通响应的调用路径

Flush 和 Hijack 解决的是两种不同的连接问题

Flush 仍然处于 HTTP 响应模型里，它只是请求当前响应链把已写内容向客户端推进。适合 SSE、进度输出和分段结果，但它不能保证客户端立刻渲染，也不能绕过代理缓冲。

Hijack 则是连接所有权的切换。调用成功后，调用方得到 net.Conn 和读写缓冲对象，后续协议处理不再由 net/http 的普通响应流程负责。它更像“离开 HTTP 服务端的默认轨道”，所以只在确实要接管连接时使用。

func takeOver(w http.ResponseWriter) (net.Conn, *bufio.ReadWriter, error) {
    controller := http.NewResponseController(w)
    conn, rw, err := controller.Hijack()
    if err != nil {
        if errors.Is(err, http.ErrNotSupported) {
            return nil, nil, fmt.Errorf("Hijack 不可用: %w", err)
        }
        return nil, nil, err
    }
    return conn, rw, nil
}

探测失败时不要把 ErrNotSupported 改写成“连接断开”。前者说明响应对象没有暴露所需能力，后者才是网络链路或对端行为问题。

ResponseController 通过 Hijack 切换连接控制权，ErrNotSupported 进入回退分支