Closed
[A2A HTTP Server] 连接管理缺陷:connections_ 缺少空闲超时回收机制,长期运行可能导致文件描述符泄漏 #25
张鑫宇Add on  Jun 15Closed at  12 hours ago
张鑫宇
张鑫宇Collaborators
Jun 15 Create

Paired: GitHub #134 ↔ GitCode #25

问题描述

在 A2A::Server::HttpServer 的实现中(src/server/http_server.cpp 和 src/server/http_server.h),connections_ 映射表使用文件描述符作为键,存储所有活跃连接。但存在以下问题:

1. lastActivity 从未被使用

ConnectionContext 结构体包含 lastActivity 字段(第56行),HandleRead 方法中也会更新该字段(第302行),但整个代码库中没有任何地方利用这个时间戳来检测并关闭空闲连接。

// http_server.h L53-56
struct ConnectionContext {
    std::string requestBuffer;
    Http::HttpRequest currentRequest;
    std::chrono::steady_clock::time_point lastActivity;  // 赋值了,但从未使用
    ...

2. 无空闲超时机制

如果一个客户端建立 TCP 连接后不发送任何数据(或者发送了 header 后 hang 住不发送 body),该连接条目会在 connections_ 中永久保留,直到进程退出。对于长时间运行的服务器,这会导致:

  • connections_ 映射表无限增长
  • 文件描述符泄漏,最终达到系统 ulimit -n 限制
  • 后续客户端无法建立新连接

3. 没有最大连接数限制

HTTP_LISTEN_BACKLOG = 128 只控制了 listen 队列长度,但 accept 后的连接数没有上限。

建议修复方案

  1. 增加周期性连接清扫任务:利用已有的 libevent 事件循环,注册一个定时器(如每30秒),遍历 connections_,将 lastActivity 超过阈值(如300秒)的连接关闭并清理
  2. 对外暴露连接超时配置:在 HttpConfig 或新增 ServerConfig 中增加 connectionTimeoutSeconds 配置项
  3. 可选:增加 maxConnections 配置项,拒绝超过上限的新连接

预期收益

  • 防止生产环境长期运行后的资源泄漏
  • 提升服务器在异常网络环境下的健壮性
  • 占用内存可预测,便于容量规划
likedislike
OopenJiuwen-botCollaborators
Jun 15 Added label: sig/sig-agent-protocol
openJiuwen-botCollaborators
Jun 15 Comments:

欢迎来到 openJiuwen 社区

Hey @xinyu-jiuwen , 感谢你对社区的贡献.

机器人使用手册

有关指令的使用,可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。

联系指引

有疑问可以联系 SIG: sig-agent-protocol ,
维护者是: @YiyangShao, @xinyu-jiuwen ,
审核者是: @gcw_hx9prznZ, @mingo007 .

likedislike
Yuren1231
Oct 14 Comments:

感谢反馈,这个问题已确认并提交修复 PR:#338 fix(server): reclaim idle HTTP connections to prevent fd leaks

根因:ConnectionContext::lastActivity 只被写入(accept 时与每次读事件)却从未被读取,connections_ 中没有基于它的回收逻辑,静默/半挂起的连接会一直保留到进程退出,最终耗尽 fd。

改动要点:

  1. 新增 ConnectionTimeoutConfig{timeoutSeconds, sweepIntervalSeconds},经 HttpConfig / HttpServerManagerConfig 贯通到 HttpServer;timeoutSeconds = 0 可关闭回收,默认 300s 超时、30s 清扫(建议值,可按部署调整)。
  2. HttpServer::Run() 复用已有 libevent 事件循环注册持久定时器,周期性关闭 lastActivity 超龄的连接(复用 CleanupConnection,TLS 状态一并释放)。
  3. 出方向发送也刷新 lastActivity,流式响应中的连接不会被误杀;Stop() 先摘除定时器再清理连接表。

issue 建议的第 3 点 maxConnections 涉及超限时的拒绝策略(状态码/可观测性),留待维护者决策,本次未实现。

验证:新增 12 个 UT + 2 个真实事件循环端到端用例(空闲连接被回收;活跃连接跨多次 sweep 存活、静默后即回收),并做了负向对照(注掉清扫注册后用例如期失败);全量 847 个 UT 仅 1 个与端口占用相关的既有失败(StartWithDifferentConfig,改动前同样失败)。欢迎 review,有异议我会尽快修正。

likedislike
Oopenjiuwen-syncCollaborators
Oct 14 Modify description of issue
WwangweizhenCollaborators
6 days ago Associated pull request
OopenJiuwen-botCollaborators
12 hours ago Close issue