不能直接用Context.WriteStream——Echo的echo.Context没有该方法;必须手动操作c.Response().Writer,提前设置Content-Type和WriteHeader,每次写入后调用Flush(),并禁用gzip等缓冲中间件。

Context.WriteStream 能不能直接用?
不能直接用 WriteStream —— Echo 的 echo.Context 根本没有这个方法。这是常见误解,源于混淆了其他框架(比如 Gin 的 Stream)或误读文档。Echo 原生不提供类似 c.Stream(...) 的封装,必须手动操作底层 http.ResponseWriter。
- 必须先调用
c.Response().Writer获取原始 writer - 需手动设置响应头,尤其是
Content-Type和Transfer-Encoding: chunked(或禁用缓冲) - 不能在调用
c.String()、c.JSON()等之后再写流,会 panic:http: response.WriteHeader on hijacked connection
如何用 Context 实现 SSE(Server-Sent Events)
SSE 是最典型的流式场景,适合日志推送、实时通知。关键在于保持连接、分块写入、正确设置 header:
- 调用
c.Response().Header().Set("Content-Type", "text/event-stream") - 设置
c.Response().Header().Set("Cache-Control", "no-cache")和"Connection", "keep-alive" - 必须调用
c.Response().Flush()每次写完一条消息后,否则数据卡在缓冲区 - 示例片段:
c.Response().Header().Set("Content-Type", "text/event-stream") c.Response().Header().Set("Cache-Control", "no-cache") c.Response().Header().Set("Connection", "keep-alive")
for i := 0; i
普通 chunked 流(非 SSE)要注意什么
如果只是想边生成边返回 HTML/JSON 片段(比如大列表分页渲染),需绕过 Echo 默认的响应缓冲机制:
Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 调用
c.Response().Writer.(http.Hijacker)并Hijack()是高风险操作,不推荐;应优先用Flush() - 确保没启用中间件如
gzip,它会拦截并缓冲所有输出,导致流失效 - 若使用
echo.HTTPErrorHandler或自定义 recovery 中间件,要确认它们不会在流进行中意外调用WriteHeader - 启动前显式关闭默认压缩:
e.Use(middleware.GzipWithConfig(middleware.GzipConfig{Level: -1}))(即禁用)
为什么 WriteHeader(200) 要提前调用?
Echo 默认延迟写 header,直到第一次 Write 或显式 c.String()。但流式响应要求 header 尽早发出,否则客户端无法识别流类型:
- 在写任何数据前,手动调用
c.Response().WriteHeader(http.StatusOK) - 如果漏掉这步,部分客户端(如 curl)可能等不到 header 就超时,浏览器也可能拒绝解析 event-stream
- 注意:调用
WriteHeader后不能再修改 header(会静默忽略),所以 header 设置必须在它之前完成
流式响应真正难的不是写几行代码,而是控制好缓冲、避免中间件干扰、以及理解 HTTP 连接生命周期——这些地方一错,表现就是“没反应”或“一次性全吐出来”。










