Echo 中流式响应需禁用 Content-Length、压缩中间件及反代缓冲,手动控制 flush 与心跳,并校验路径防穿透;SSE 必须显式 WriteHeader 和 Flush。

echo.File() 默认就走 chunked,但得避开 e.Static()
大文件流式响应不用手动启 chunked,echo.File() 底层调用 http.ServeFile + io.Copy,天然触发 Transfer-Encoding: chunked,前提是不设 Content-Length 且响应头里没冲突字段。而 e.Static() 是基于 http.FileServer,它对 50MB+ 视频或日志文件大概率直接卡死或内存暴涨——它不支持 Range、不处理缓冲超时、也不分块。
- 用
c.File(filepath)替代e.Static(),尤其在GET /video/:filename这类动态路径下 - 路径校验必须做:
if strings.Contains(filename, "..") || strings.HasPrefix(filename, "."),否则../etc/passwd会穿透 - 绝对不要手动写
c.Response().Header().Set("Content-Length", ...),Echo v4.12+ 会自动推断;错设会导致浏览器解析失败或白屏
手动构造 chunked 响应时,禁止混用 Content-Length 和压缩中间件
当你需要流式返回日志尾部、SQL 查询结果或 SSE 事件,就得绕过 c.File(),自己控制响应流。此时关键不是“怎么开 chunked”,而是“怎么不破坏它”——HTTP 协议规定 Content-Length 和 Transfer-Encoding: chunked 互斥,共存会让 Nginx、ALB 或浏览器直接拒收或降级为 close-connection。
- 响应头只保留
Transfer-Encoding: chunked,删掉所有Content-Length注入逻辑(包括自定义中间件里的ctx.Response().Header().Del("Content-Length")) - 禁用全局 gzip/zstd 压缩:
e.Use(middleware.Gzip())必须移除,压缩会缓冲整条响应体,chunked 就失效了 - 如果走 Nginx 反代,确认
proxy_buffering off;和proxy_cache off;已生效;chunked_transfer_encoding on;对proxy_pass无效,真正起效的是上游(Echo)不发Content-Length
SSE 场景必须手动 WriteHeader + Flush,不能依赖 c.String()/c.JSON()
text/event-stream 是 chunked 的特化形式,但 Echo 不会自动适配它的实时性要求:默认 c.String() 等方法会等 handler 返回才发头和体,而 SSE 要求 header 立即写出、每条 data: 后立刻 flush,否则客户端卡在 loading 或报 ERR_INVALID_CHUNKED_ENCODING。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 先设头:
c.Response().Header().Set("Content-Type", "text/event-stream")、Cache-Control: no-cache、Connection: keep-alive - 必须显式调用
c.Response().Writer.WriteHeader(http.StatusOK),不能靠 Echo 自动写状态码 - 用
rw := c.Response().Writer断言为http.Flusher,每次写完完整事件(如"data: hello\n\n")后立刻rw.(http.Flusher).Flush() - 每 20 秒补一个空心跳
"\n\n",仅靠retry:字段防不住代理层空闲超时
连接中断检测别只靠 context.Done()
流式场景下,客户端关浏览器、网络抖动或代理超时都会导致连接静默断开。但 context.Done() 在某些情况下延迟高甚至不触发(比如 TCP FIN 未被及时感知),光靠它会持续往已断连接写数据,引发 write: broken pipe 错误。
- 在循环写 chunk 前加
if !c.Response().Committed() && c.Request().Context().Err() != nil判断是否还能写 - 对长周期流(如日志 tail),每写几块后主动调用
rw.(http.Hijacker).Hijack()检查底层 conn 是否可读/可写(需谨慎,可能破坏 HTTP 生命周期) - 更稳妥的做法是结合
net.Conn.SetReadDeadline()和心跳响应,但 Echo 默认不暴露原始 conn,需在中间件中提前劫持
流式传输的复杂点不在协议本身,而在层层中间件、反向代理和客户端实现对 chunked 的兼容性差异——同一段代码,在本地直连能跑通,放到 K8s Ingress 后就卡住,往往是因为某一层偷偷加了 Content-Length 或开了 buffer。动手前先用 curl -i 看真实响应头,比查文档更快定位问题。










