Iris中长轮询需手动实现:用ctx.Request().Context()监听取消,循环检测+time.Sleep控制等待,每次写入后调Flush()并设合适Content-Type;须防goroutine泄漏、连接关闭后写入等错误。

长轮询在Iris中怎么写 handler?
长轮询不是开个定时器不断发请求,而是服务端主动 hold 住响应,等有数据才返回。Iris 本身不内置长轮询抽象,但用 ctx.ResponseWriter().Flush() + time.Sleep + 循环检测就能实现。关键点是:别让 HTTP 连接提前关闭,也别让 Goroutine 泄漏。
常见错误现象:http: response.WriteHeader on hijacked connection(误用了 Hijack)、context canceled(客户端断连后还往已关闭的 writer 写)、Goroutine 积压导致内存暴涨。
- 必须用
ctx.Request().Context()监听取消信号,退出循环 - 每次写入后调用
ctx.ResponseWriter().Flush(),否则浏览器收不到 chunk - 响应头要设
Content-Type: text/event-stream或text/plain,避免被代理缓存 - 建议加超时兜底(比如最长等待 30s),防止连接无限挂起
客户端怎么保持连接不中断?
浏览器原生没有长轮询封装,得自己用 fetch 或 XMLHttpRequest 控制流程。不能依赖 setInterval 简单轮询,否则就是短轮询,浪费资源。
典型陷阱:请求发出去后没监听 abort,上一个请求还没结束就发了下一个,造成连接堆积;或没处理 502/504,直接静默失败。
- 每次发起新请求前,先
abortController.abort()上一个 pending 请求 - 用
fetch(url, { signal: abortController.signal })绑定生命周期 - 收到响应后立即发起下一次请求——但要在
then里做,不是靠定时器 - 服务端返回非 2xx 时,延迟 1–3s 后重试,避免雪崩
和 SSE、WebSocket 混用时要注意什么?
Iris 可以同时暴露 /events(SSE)、/ws(WebSocket)、/poll(长轮询)三个端点,但它们共享同一套业务状态监听逻辑。问题常出在「状态变更通知分发」这一层。
容易踩的坑:用全局 channel 广播消息,但没做缓冲或限流,导致长轮询 goroutine 被阻塞;或对 SSE 用了 event: xxx 格式,却忘了给长轮询返回纯 JSON,前端解析报错。
- 状态变更应写入带缓冲的 channel(如
make(chan any, 100)),避免生产者卡住 - 长轮询 handler 里从 channel 读取时,要用
select套ctx.Done(),而不是直接 - 统一用
json.Marshal输出,别混用fmt.Fprintf拼字符串,否则字段缺失难排查 - 如果启用了 Nginx,需配置
proxy_buffering off和proxy_cache off,否则长轮询响应会被缓存
为什么不用 Iris 插件而手动实现?
目前 Iris 生态里没有成熟、轻量、可维护的长轮询中间件。第三方插件要么耦合 Redis 订阅,要么强制要求用 WebSocket fallback,反而增加复杂度。
真实项目里,长轮询往往只用于特定场景:低频更新的大屏看板、内网老旧终端兼容、或作为 WebSocket 断连后的临时降级路径。硬套通用方案,不如根据业务节奏控制 poll 频率与 payload 大小。
最易被忽略的一点:长轮询不是“退而求其次”的兜底,而是明确设计为「按需触发 + 低频保活」。比如每 10s 检查一次是否有新告警,有则立即返回,无则等满 10s 后返回空响应并由客户端续连——这个 10s 是业务语义,不是随便写的。


















