Open
HTTP 长订阅缺少心跳与断开检测,订阅名额可能长期不释放 #1
soulsoftAdd on  4 hours ago
soulsoft
soulsoftCollaborators
4 hours ago Create

现象(代码可确认)

  • HTTP 的 subscriptions/listen 强制走 SSE(mcp/src/server/streamable_http_post_transport.cj:33),POST 响应流保持到订阅结束。
  • 断开检测只发生在写响应失败时(mcp/src/server/streamable_http_post_transport.cj:118-145)。订阅源没有新事件时不会写,因此在下一次发送之前无法感知断开。
  • _closed 之后 sendMessage 直接 return(:71-77),不上报错误;当前也没有日志或计数。

影响(在满足条件时)

  • 订阅任务通过 submit(longRunning=true) 单独 spawn(mcp/src/common/bounded_work_executor.cj:53)。如果 handler 不返回、服务端也不关闭,任务会继续占用 maxConcurrentSubscriptions(默认 16)中的一个名额。
  • 这是“名额可能长期不释放”,不是必然泄漏:订阅源持续有事件时,写失败会导致该 POST 关闭。
  • context.isCancelled 在 HTTP 断开路径上不会被置位;只有服务端整体 close() 会取消订阅(mcp/src/server/mcp_server_impl.cj:129-144)。

未验证的风险

  • TCP 半开时小帧写入是否报错或阻塞,取决于 stdx/Spire 的写实现,本仓库无法确认,需要实测。
  • 没有 keepalive 或写超时(代码中没有相关配置)。

建议

  1. SSE 注释帧心跳(: ping\n\n)并加写超时;是否可实现取决于框架对写超时的支持。
  2. 写失败或检测到连接关闭时,对该 POST 的 RequestContext 调 cancel()。
  3. 订阅 handler 检查 isCancelled 并主动结束。
  4. _closed 后的静默丢弃增加日志或计数。

验收

  • 实现心跳后,断开能在心跳间隔 + 超时窗口内被检测到。
  • 覆盖两种订阅:持续有事件、长期无事件。
likedislike
soulsoftsoulsoftCollaborators
4 hours ago Change title to "HTTP 长订阅缺少心跳与断开检测,订阅名额可能长期不释放", originally titled "HTTP 长订阅缺少心跳与断开检测,会泄漏订阅名额".
soulsoftsoulsoftCollaborators
4 hours ago Modify description of issue