Revel框架本身不内置长轮询支持,但可通过注册原生http.Handler复用其路由与中间件,结合context.Context取消机制、定时器超时控制及channel消息传递,安全实现可中断的长轮询;需规避阻塞Action、未设超时、非线程安全状态存储等常见错误,并建议优先评估WebSocket或SSE替代方案。

Revel 框架本身不内置长轮询支持,但你可以用标准 Go HTTP 处理器 + Revel 的路由和依赖注入能力,手动实现一个可控、可中断的长轮询端点。关键不是“Revel 怎么做长轮询”,而是“在 Revel 项目里,如何安全地挂起一个 HTTP 请求直到有数据或超时”。
为什么不能直接在 Revel Action 里 sleep 或循环等待
Revel 的 Controller.Action 方法默认运行在同步上下文中,如果在里面写 time.Sleep 或阻塞式轮询(比如反复查 Redis),会直接卡住整个 Goroutine,而 Revel 默认使用同步 HTTP handler,这会导致连接堆积、线程耗尽、响应延迟飙升。
必须把等待逻辑移出主线程,且要能被客户端断开或服务端主动终止。常见错误是:
- 在
MyController.LongPoll()里直接for { if hasNew() { break }; time.Sleep(100 * time.Millisecond) }—— 这等于把 HTTP handler 当成定时任务跑,不可扩展 - 忘了设置
http.TimeoutHandler或没配ReadTimeout,导致客户端断连后连接还挂在服务端(TIME_WAIT 状态堆积) - 用全局变量或非线程安全 map 存储 pending 请求,高并发下 panic 或数据错乱
用 http.ResponseWriter + context.Context 实现可取消长轮询
Revel 允许你绕过 Controller,注册原生 http.Handler。这是最干净的做法:既复用 Revel 的路由注册和中间件(如鉴权),又避开 Action 生命周期约束。
实操要点:
- 在
app/init.go的init()函数里,用revel.InterceptFunc或直接revel.Router.Add注册一个自定义 handler,路径如/api/longpoll - handler 内部立刻调用
w.(http.Flusher).Flush(),确保响应头发出,避免浏览器缓存拦截 - 用
r.Context().Done()监听客户端断连;用time.AfterFunc或timer.Reset()控制最大等待时间(建议 20–30 秒) - 数据源推荐用
chan interface{}或redis.PubSubConn,避免轮询数据库;每次有新消息就select发送到所有等待的 channel
简短示意(非完整代码,仅体现结构):
func longPollHandler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
w.Header().Set("Cache-Control", "no-cache")
flusher, ok := w.(http.Flusher)
if !ok { panic("expected http.Flusher") }
flusher.Flush()
<pre class="brush:php;toolbar:false;">done := r.Context().Done()
timer := time.NewTimer(30 * time.Second)
defer timer.Stop()
select {
case msg := <p>}
</p>
客户端发起长轮询时必须带唯一标识和游标
否则服务端无法判断“这个请求该等哪条数据”,也难以做幂等和去重。典型组合是:
-
client_id:由前端生成 UUID,用于服务端关联连接与用户会话(别依赖 session cookie,长轮询可能跨域或禁用 cookie) -
last_seq:上一次收到消息的序列号,服务端据此决定从哪条开始推(可用 Redis INCR 做全局序号,或 MySQL AUTO_INCREMENT) -
timeout=25:显式传超时值,和服务端 timer 匹配,避免两端不一致导致假死
前端 JS 示例(fetch 版,注意无重试逻辑):
async function startLongPoll() {
const url = `/api/longpoll?client_id=${clientId}&last_seq=${lastSeq}&timeout=25`;
try {
const res = await fetch(url, { credentials: 'include' });
const data = await res.json();
handleUpdate(data);
} catch (e) {
// 网络失败或超时,立即重试(不加 delay)
} finally {
startLongPoll(); // 总是发起下一轮
}
}
长轮询在 Revel 里真正难的是连接状态管理和资源回收
不像 WebSocket 有明确的 OnClose 回调,HTTP 长轮询的“断开”是静默的:可能是用户关页、网络闪断、代理超时、甚至运营商劫持。你没法 100% 感知。
所以必须设计兜底机制:
- 每个 pending 请求在注册时写入
map[client_id]*pendingReq,并带time.Now()时间戳 - 启动一个后台 goroutine,每 10 秒扫一次 map,剔除超过 35 秒没更新的项(比 timeout 多 10 秒)
- 用
sync.Map替代普通 map,避免读写竞争 - 不要在 handler 里直接操作数据库或调外部 API——先发到内部 channel,由 worker goroutine 统一处理,否则并发上来容易打崩 DB
最后提醒一句:长轮询只是过渡方案。如果你已经用 Revel,说明项目有一定规模,真要上即时消息,优先评估 WebSocket(Revel 支持 websocket.Upgrader)或 SSE(更轻量)。长轮询的调试成本、监控盲区和连接管理复杂度,远高于它表面看起来的“简单”。











