Merged
fix(a2a):adjust timeout config, support idle timeout in stream mode #390
wangweizhenAdd on 12 days ago
fix(a2a):adjust timeout config, support idle timeout in stream mode #390
Merged
Pull Request has been successfully merged by openJiuwen-bot.
(Thank you for wangweizhen's contribution.)12 days ago Associated issue: [A2A] 协议层超时控制体系不完善:缺少分阶段超时与可配置策略
atomgit-bot
12 days ago Comments:
12 days ago Comments:
变更摘要
本 PR 调整 A2A C++ SDK 的超时配置体系:将超时从连接层内部固定值改为可配置项,在 ClientConfig 中新增 timeoutSeconds 与 streamingIdleTimeoutSeconds,并为 AgentCard 发现、非流式请求、流式请求分别定义超时语义;流式请求不再设置总时长上限,改为基于数据到达间隔的「空闲超时」检测。同时移除了连接层原有的 FinishRequest / RefreshRequest 定时器接口(改用连接内部的周期性空闲检查),并将 libcurl 超时失败映射为带阶段信息的 A2A_REQUEST_TIMEOUT 错误。
主要改动
ClientConfig新增超时配置项: 新增timeoutSeconds(默认 300 秒,非流式总超时)与streamingIdleTimeoutSeconds(默认 60 秒,流式数据到达最大间隔),并明确SendMessage/Resubscribe的timeout形参在流式与非流式下分别表示空闲间隔与总超时。- AgentCard 发现超时参数化:
A2ACardResolver::GetAgentCard/GetAllAgentCards新增timeout形参,配合新增常量DEFAULT_CARD_TIMEOUT_SECONDS(60 秒),HttpCardResolver在timeout <= 0时回落到该默认值,以便发现阶段快速失败。 LibcurlConn三档超时与流式空闲检测: 构造函数改为接收connectTimeoutMs、requestTimeoutMs、streamIdleTimeoutMs三个参数并新增streamIdleTimeoutMs配置与DEFAULT_STREAM_IDLE_TIMEOUT_MS;SetupCurlHandle仅对非流式请求设置CURLOPT_TIMEOUT_MS,流式请求改由新增的重复定时器与OnIdleCheck依据lastActivityTime(在HeaderCallback/WriteCallback中刷新)判定空闲超时并中止请求。- 错误码与错误信息增强: 新增
CurlErrorCode/DescribeCurlError将CURLE_OPERATION_TIMEDOUT映射为A2A_REQUEST_TIMEOUT、连接类错误映射为A2A_TRANSPORT_EXCEPTION,并在消息中携带stage(connect-or-waiting-response-headers、waiting-response-body、stream-idle)与耗时;HttpResponse新增errCode字段透传该错误码,JsonRpcTransportImpl从 JSON-RPC 错误包中提取message作为错误信息。 - 连接接口与定时器机制收敛: 删除
ClientConn及LibcurlConn的FinishRequest/RefreshRequest纯虚接口与UserData中的timerId/timeout字段,移除JsonRpcTransportImpl中各处对这两个接口的调用,并新增SECONDS_TO_MS作为秒到毫秒的统一换算常量;同时补充examples/timeout_client.cpp打桩验证程序及相应 UT 调整。


Incorrect?
atomgit-bot
12 days ago Comments:
12 days ago Comments:
代码审查
审查结论
发现汇总(按严重度)
| 严重度 | 数量 | 说明 |
|---|---|---|
| P0 | 0 | — |
| P1 | 0 | — |
| P2 | 2 | 配置超时值被下层私有上限拒绝导致 Create 静默返回 nullptr;核心新逻辑 OnIdleCheck 无 UT 覆盖 |
| P3 | 4 | 流式 connect 超时被误标 stream-idle;空闲定时器创建失败后流式无兜底;per-call 秒转毫秒无上界/溢出保护;示例桩 listenFd_ 数据竞争 |
逐文件复核确认
A2A/cpp-sdk/CMakeLists.txt:no issues(仅把timeout_client加入示例输出目录循环,if(TARGET ...)保护已存在)A2A/cpp-sdk/examples/CMakeLists.txt:no issues(新增目标位于if(A2A_BUILD_CLIENT)内,链接方式与既有示例一致)A2A/cpp-sdk/examples/timeout_client.cpp:1 项发现(listenFd_跨线程数据竞争);其余经核对 API 均存在(A2AClientTimeoutError、ClientFactory::Create(card,cfg)、ClientEvent/ResponseHandler、Part::text、Log::SetLogLevel),client_factory.h已包含client.h,不会因缺声明编译失败A2A/cpp-sdk/include/client/a2a_card_resolver.h:no issues(新增纯虚参数有默认值,全仓无其它子类,未产生 override 编译破坏)A2A/cpp-sdk/include/client/client.h:no issues(注释已说明秒级语义;上限缺失问题已在 transport 侧报告)A2A/cpp-sdk/include/client/http_card_resolver_builder.h:no issues(仅注释)A2A/cpp-sdk/src/client/connection/client_conn.h:no issues(FinishRequest/RefreshRequest已无任何残留引用,LibcurlConn/MockClientConn均已同步)A2A/cpp-sdk/src/client/connection/libcurl_conn.cpp:3 项发现(DescribeCurlError阶段误标、空闲定时器失败无兜底、timeoutSecs溢出/无上界)+ 1 项测试覆盖缺失A2A/cpp-sdk/src/client/connection/libcurl_conn.h:no issues(常量、RequestContext初始化顺序、lastActivityTime(startTime)均正确)A2A/cpp-sdk/src/client/http_card_resolver.cpp:no issues(timeout>0回退 60s,与文档一致)A2A/cpp-sdk/src/client/http_card_resolver.h:no issuesA2A/cpp-sdk/src/client/jsonrpc_transport_impl.cpp:1 项发现(config 秒数上界/溢出 →Create返回 nullptr)A2A/cpp-sdk/src/shared/common_types.h:no issues(timerId/timeout删除后无残留引用)A2A/cpp-sdk/src/shared/http_common.h:no issues(新增errCode字段默认 0,兼容旧调用)A2A/cpp-sdk/tests/ut/client/test_jsonrpc_transport_impl.cpp:no issues(删除的两处 mock 在文件中无对应期望调用)A2A/cpp-sdk/tests/ut/client/test_libcurl_conn.cpp:no issues(仅删FinishRequest用例;构造函数 4 参调用因新签名默认参数仍可编译);但新增空闲中止路径的用例缺失已在libcurl_conn.cpp:826报告
整体风险判断
改动方向与 issue #29 一致,错误码/异常类型链路(CurlErrorCode → SendError → TransportError → A2AClientTimeoutError(-32101))经逐段核对是通的,未发现构建破坏或数据损坏级缺陷。主要风险集中在两点:公开配置项(秒级超时)与传输层私有上限(30min)之间缺少一致的边界校验,超限时会退化为 ClientFactory::Create 静默返回 nullptr(P2,最应优先修);以及流式空闲超时这一全新并发路径完全没有 UT 兜底,后续微小改动就可能变成静默挂死或 UAF 而不被 CI 捕获(P2)。建议合入前至少修复这两项,其余 P3 可按排期跟进。
| 类型 | 数量 |
|---|---|
| 🔴 阻塞 | 0 |
| 🟡 建议 | 2 |
💬 仅评论


Incorrect?
12 days ago Set YiyangShao,xinyu-jiuwen as approver
atomgit-bot
12 days ago Comments:
12 days ago Comments:
121 messages are collapsed here。 See more
6 days ago Added label: approvedlgtm-mingo007
openJiuwen-bot
6 days ago Comments:
6 days ago Comments:
6 days ago Closed associated issue
6 days ago Merged pull request
6 days ago Removed label: ci-successful
Paired: GitHub #201 ↔ GitCode !390
What type of PR is this?
/kind
Self-checklist:(请自检,在[ ]内打上x,我们将检视你的完成情况,否则会导致pr无法合入)