直接流式写入才是正解:避免预缓存、禁用Content-Length、每次语义单元后Flush并检查context.Done()。

不拼接,直接流式写入才是正解
Go 的 http.ResponseWriter 本身不负责“拼字符串再发”,它只管把字节流塞进底层连接缓冲区。所谓“分块传输”不是你手动拼 "4\r\nabcd\r\n" 这种 chunk 格式——那是 HTTP/1.1 协议层的事,net/http 已经自动封装好了。你唯一要做的,是避免拦住它启用 chunked 的路。
常见错误是:先用 bytes.Buffer 或 strings.Builder 把所有内容攒起来,最后 w.Write(buf.Bytes())。这等于告诉 Go:“我知道总长度”,它就会设 Content-Length 并禁用 chunked,整个流式意图就废了。
- 永远不要提前
buf.String()或buf.Bytes()全量读取 - 别用
fmt.Sprintf拼大字符串再写;小片段(如 JSON key)可接受,但整段响应不行 - 如果必须构造结构化数据(比如逐行日志),用
json.Encoder直接写入w,它内部会按对象刷,不缓存全文
怎么让每个逻辑单元真正发出去
Write() 只进缓冲区,不发包。哪怕你写了 w.Write([]byte("hello")),客户端也可能卡住几秒甚至等到 handler 结束才看到。关键动作是 Flush(),但它不是无条件可用的。
必须先判断响应体是否支持刷新:
立即学习“go语言免费学习笔记(深入)”;
if f, ok := w.(http.Flusher); ok {
f.Flush()
} else {
// 降级:无法 flush,只能等 handler 结束或缓冲区满
}
典型场景中,每写一个语义完整的单元(如一条日志、一个 JSON 对象、一个 HTML 片段)后紧跟一次 Flush()。不要在循环里每字节都 flush,也不要隔几秒才 flush 一次——前者 syscall 开销大,后者用户体验差。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 使用
bufio.NewWriter(w)包一层再 flush,能减少系统调用次数,但记得最终bw.Flush() - 在
for循环中,每次Write()后立即Flush(),而不是只在循环末尾 flush 一次 -
curl -N或浏览器 devtools 的 Network → Response 面板,是验证是否真正在流式输出的最直接方式
Content-Length 是 chunked 最常见的隐形杀手
只要响应头里出现 Content-Length,无论值是否准确,chunked 就立刻失效。而这个头可能来自你完全没意识到的地方:
- 中间件(比如某些 logger、auth、gzip wrapper)偷偷设置了
Content-Length - 调用了
http.Error()或http.Redirect(),它们内部会写死长度 - 用了
http.ServeFile()或http.FileServer,它们基于文件 stat 自动设长度 - 甚至
w.Header().Set("Content-Type", "...")之后又调了w.WriteHeader(200),但没写 body,连接被提前关闭,导致后续 Write 失效
排查方法很简单:启动服务后,用 curl -i http://localhost:8080/your-path 看响应头。如果没看到 Transfer-Encoding: chunked,第一反应不是代码没 flush,而是检查有没有 Content-Length 出现。
context.Done() 必须在每次 Write/Flush 前检查
流式响应一旦开始写 body,状态码和 header 就锁死了。如果客户端断开或超时,r.Context().Done() 会被 close,但你的 goroutine 可能还在循环里拼命 Write(),直到下一次 Flush() 返回 write: broken pipe 才停下——这时已经晚了,部分 chunk 已发出去但不完整,前端解析失败。
正确做法是在每次操作前主动感知:
select {
case <-r.Context().Done():
return // 优雅退出,不写也不 flush
default:
}
_, err := w.Write(data)
if err != nil {
return
}
if f, ok := w.(http.Flusher); ok {
f.Flush()
}
注意:ctx.Err() 不是只在第一次检查才有用,每次 Write/Flush 前都要查。忽略这点,90% 的流式接口在线上都会遇到 ERR_INCOMPLETE_CHUNKED_ENCODING 或前端卡死问题。
真正麻烦的不是怎么开启 chunked,而是你根本不知道哪个中间件、哪行日志、哪个 error 处理悄悄把它关掉了。盯紧响应头里的 Content-Length,比调十次 Flush() 更管用。

















