Go的http.ResponseWriter默认自动启用chunked编码，前提是不设置Content-Length且未提前WriteHeader；需用http.Flusher.Flush()触发发送，并注意HTTP/2下该机制被帧传输替代。
Go 的 http.ResponseWriter 默认就支持 chunked 编码，不用手动设置
只要你不显式调用 WriteHeader 设置状态码（或设了但没写入响应体），且没设置 Content-Length 头，Go 的 HTTP 服务在写入响应体时就会自动启用 chunked transfer encoding。这是 net/http 包的默认行为，不是“要开启”，而是“不阻止就会用”。
常见错误现象：curl -i 看不到 Transfer-Encoding: chunked，或者浏览器收不到流式数据 —— 很可能是因为你提前写了 Content-Length，或者调用了 WriteHeader(200) 后又忘了写内容，导致连接被提前关闭。
- 不要手动设置
Content-Length：一旦设置了，chunked 就会被禁用，Go 会按固定长度等待写满才发包 - 避免过早调用
WriteHeader：如果只是想写状态码，可以不调；需要自定义状态码时再调，但之后必须有写入操作 - 写完记得 flush：用
http.Flusher接口的Flush()方法，否则数据可能卡在缓冲区（尤其在小数据、本地测试时更明显）
如何安全地做流式响应：检查 http.Flusher 并逐块 Write + Flush
不是所有 http.ResponseWriter 都实现了 http.Flusher（比如某些中间件包装后的响应体可能不支持），直接断言或调用会 panic。必须先类型断言，失败时降级处理（比如拼接后一次性返回）。
使用场景：日志尾部、SSE（Server-Sent Events）、大文件分片生成、AI 流式 token 输出。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
if f, ok := w.(http.Flusher); ok { ... }判断是否可 flush - 每次
f.Write([]byte(...))后紧跟f.Flush()，否则数据不会真正发出 - 注意并发安全：同一个
http.ResponseWriter不应在多个 goroutine 中同时写，如需并发推送，应改用 channel + 单 goroutine 消费模式 - 避免高频 flush：每毫秒都
Flush()会显著增加 syscall 开销，建议按语义边界 flush（如每条日志、每个 JSON 对象）
chunked 下的错误处理很脆弱：连接中断时无法补救
HTTP/1.1 chunked 编码是单向流，一旦开始写响应体，就无法再修改状态码或响应头。如果中途发生 panic、数据库超时或业务逻辑出错，你只能中断连接，客户端收到的是截断的 chunked 数据，大概率解析失败。
常见错误现象：前端报 ERR_INCOMPLETE_CHUNKED_ENCODING 或解析 JSON 时卡在半截；curl 显示 “transfer closed with outstanding read data remaining”。
- 关键逻辑务必前置校验：权限、参数、资源可用性等，别等到写到一半才发现没权限
- 慎用 defer recover：recover 无法挽回已写出的 chunk，反而掩盖问题；更适合用 context 超时控制整个 handler
- 日志里记录 flush 前的状态：比如写入第 N 条数据时 flush，方便定位中断点
- 客户端必须容错：对 chunked 响应做分块解析，遇到连接关闭就终止，而不是死等
和 HTTP/2 的区别：Go 1.12+ 默认启用 h2，但 chunked 在 h2 中实际不生效
HTTP/2 没有 chunked encoding 的概念，它原生支持消息分帧和流式传输。当客户端通过 TLS + ALPN 协商使用 HTTP/2 时，即使你手动写了 Transfer-Encoding: chunked，Go 也会忽略并走 h2 的 DATA 帧机制。
这意味着：你在本地用 curl http:// 测试看到 chunked，换成 https:// 可能就看不到该 header，但流式行为依然存在 —— 不是失效了，是换了一种底层实现。
- 别依赖
Transfer-Encodingheader 是否存在来判断流式是否生效 - 测试时优先用真实客户端（浏览器、Postman、带 h2 支持的 curl），而不是只看 header
- HTTP/2 下 flush 仍然必要，但语义变为“触发帧发送”，不是“发一个 chunk”
- 如果必须兼容老客户端（HTTP/1.1 only），确保 server 没禁用 h1，或明确用
http.Server{TLSConfig: ...}控制 ALPN
