Pull Request has been successfully merged by openJiuwen-bot.
(Thank you for Yiyang Shao's contribution.)变更摘要
本 PR 聚焦 MCP 与 A2A 两套 C++ SDK 共用的 HTTP 报文解析逻辑,将 Content-Length 的处理从原先基于 std::stoul 的宽松解析改为严格校验:新增 HttpParseStatus 枚举并通过 ParseHeadersAndBody 的可选输出参数区分 COMPLETE、INCOMPLETE 与 INVALID,拒绝非法十进制长度、重复长度头、逗号列表以及与 Transfer-Encoding 并存的歧义报文,同时修复头部边界检查的加法溢出问题,并让 MCP 同步客户端在收到非法报文或连接提前关闭时立即返回失败。两套公共 HTTP 测试同步补充了长度边界用例,并把原先把非法长度视为解析成功的预期改为拒绝。
主要改动
- 新增解析状态输出接口: 在 MCP 与 A2A 的
http_common.h中新增enum class HttpParseStatus { COMPLETE, INCOMPLETE, INVALID },ParseHeadersAndBody增加默认值为nullptr的HttpParseStatus* status参数,保持原有bool调用方式兼容,失败时consumedBytes保持为零。 - 严格解析 Content-Length: 使用
std::from_chars解析完整非负十进制size_t,要求解析指针到达字符串末尾,拒绝空值、符号、小数、内嵌空格、尾随字符及溢出,同时保留合法首尾空白与前导零;头部字段名统一小写化后按content-length匹配。 - 拒绝歧义消息定界: 解析过程中记录
hasContentLength与hasTransferEncoding,重复Content-Length(含大小写不同但同名)直接判为INVALID,Content-Length与Transfer-Encoding同时出现同样拒绝,避免头部 map 覆盖导致的边界歧义。 - 头部边界溢出修复: 将
headerEnd + HTTP_HEADER_BODY_SEPARATOR_LENGTH > buffer.size()改为headerEnd > buffer.size() || buffer.size() - headerEnd < HTTP_HEADER_BODY_SEPARATOR_LENGTH,通过减法比较避免加法回绕。 - MCP 同步客户端失败语义:
ParseHttpResponse增加HttpParseStatus&参数透传解析结果,SendRequest在INVALID时立即置error并结束接收;OnClose回调在响应未完成时补充error = true,连接提前关闭不再产生成功响应;测试侧将非法长度用例预期改为EXPECT_FALSE并新增非法十进制、重复/冲突字段、合法空白、分段重试、size_t上界与头部偏移溢出等用例。


代码审查
全部检查已完成,两处问题已上报,进入总结。
审查结论
已上报问题
| # | 优先级 | 文件:行 | 问题 |
|---|---|---|---|
| 1 | P1 | MCP/cpp-sdk/src/client/http_client.cpp:122-129 |
OnClose 中新增的 error = true 在响应数据尚未解析前就判定失败,导致"响应数据与 FIN 同批到达"时丢弃完全合法的响应(Connection: close 下高频触发),属本次引入的行为回归 |
| 2 | P3 | MCP/cpp-sdk/src/client/http_client.cpp:138-149 |
新增的 HttpParseStatus 三分支状态机及 OnClose 失败判定没有任何回调路径测试,上述回归无测试拦截 |
逐文件确认
A2A/cpp-sdk/src/shared/http_common.cpp— 无问题。长度解析改用std::from_chars并校验ec/ptr,空值、符号、尾随字符、溢出均被拒;重复Content-Length、CL+TE 并存被拒;头边界检查改为减法形式,headerEnd > buffer.size()+size() - headerEnd < 4无溢出,consumedBytes = bodyStart + contentLength仅在size() - bodyStart >= contentLength时执行,不会溢出。A2A/cpp-sdk/src/shared/http_common.h— 无问题。新增HttpParseStatus与可选尾参status = nullptr,注释同步更新;该文件ParseHeadersAndBody在 A2Asrc/内无生产调用方(服务端走 nodejshttp_parser),风险面仅限测试。A2A/cpp-sdk/tests/ut/shared/test_http_common.cpp— 无问题(仅一处可选清理:文件末尾仍无换行,属既有风格,未报)。新增用例覆盖非法十进制、重复/传输编码冲突、合法空白、分段重试、size_t上界与头偏移回绕;InvalidContentLength的预期已由"成功"改为"拒绝",与实现一致。MCP/cpp-sdk/src/client/http_client.cpp— 发现 2 处(见上)。MCP/cpp-sdk/src/shared/http_common.cpp— 无问题。除与 A2A 相同的严格化逻辑外,headers[normalizedKey]保持了原std::transform(...::tolower)后存小写键的既有契约(CONTENT_LENGTH_HEADER等常量为小写),未改变getContentType等消费方行为。MCP/cpp-sdk/src/shared/http_common.h— 无问题。声明与实现一致,默认参数保持源码兼容。MCP/cpp-sdk/tests/ut/shared/http_common_test.cpp— 无问题。与 A2A 侧用例对称,ParseHeadersAndBody_InvalidContentLength的预期同步更新为false/body为空 /consumedBytes == 0。
总体风险判断
解析层严格化本身实现正确、边界处理到位(溢出、回绕、重复头均有防护并有测试),A2A 侧因无生产调用方风险很低。主要风险集中在 MCP 同步客户端的错误判定顺序:本次为修复"连接早关闭被误判成功"而引入的 error = true 走向了另一个极端,会把已收齐的响应误判为失败,建议按 finding 1 的方式在 OnClose 中先尝试解析残留缓冲再判定失败。
合计:P1 × 1,P3 × 1。
| 类型 | 数量 |
|---|---|
| 🔴 阻塞 | 1 |
| 🟡 建议 | 1 |
⛔ 需要修改


欢迎来到 openJiuwen 社区
Hey @YiyangShao , 感谢你对社区的贡献.
机器人使用手册
有关指令的使用,可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。
联系指引
有疑问可以联系 SIG: sig-agent-protocol ,
维护者是: @YiyangShao, @xinyu-jiuwen ,
审核者是: @gcw_hx9prznZ, @mingo007 .


/lgtm
/approve


Paired: GitHub #188 ↔ GitCode !384
问题与修复
MCP/A2A 的公共 HTTP 解析器通过 std::stoul 读取 Content-Length,转换失败后按零长度继续解析;带尾随字符的值也可能被部分接受。重复长度头在写入 map 时被覆盖,无法识别消息边界歧义。
使用 std::from_chars 严格解析完整的非负十进制 size_t 长度,拒绝空值、符号、尾随字符及溢出,同时保留合法的首尾 SP/HTAB 和前导零。
按不区分大小写的字段名识别并拒绝重复 Content-Length(包括相同值)、逗号列表,以及所有带 Transfer-Encoding 的报文(当前不支持传输编码解码,避免把 chunked 正文静默当作空响应)。
新增可选 HttpParseStatus 输出,区分 COMPLETE、INCOMPLETE 和 INVALID;保留原 bool 调用方式,失败时 consumedBytes 为零。
通过减法进行头部边界检查,避免 headerEnd 加法溢出。
MCP 同步客户端对非法报文立即返回失败;读回调和关闭回调共用解析过程,关闭时先排空 socket 缓冲区,避免响应数据与 FIN 同批到达时误判失败。正文未收齐即关闭仍返回失败。
静态检查整改:将两套解析器拆分为头字段校验与消息完整性解析,相关函数均少于 50 行;测试端口、超时和成功状态码使用命名常量;测试日志使用内联函数;补充测试替身的默认析构函数;接收缓冲区结构与真实 TcpSocket 的公开 inBuf_ 接口保持一致。
两套现有 HTTP 公共测试均补充相同的长度边界用例,并将原先把非法长度视为成功的预期改为拒绝。
验证
使用 GoogleTest v1.16.0 和 C++17,直接编译两套真实公共 HTTP 源码及对应测试文件:
git -c core.whitespace=cr-at-eol diff --cached --check:通过,测试文件保留原有换行格式。gitcode precommit check --run --yes:仓库没有 pre-commit 配置。兼容性与范围
合法单一长度头及未收全报文的重试行为保留。非法长度、重复长度和长度/传输编码冲突不再作为成功报文接受。状态参数位于 src 内部公共头文件,已有源码调用可省略它;涉及该实现的目标需要重新编译。
本次明确拒绝所有 Transfer-Encoding(含 chunked、identity 和空值),未增加解码能力。无 Content-Length 且无 Transfer-Encoding 时的消息定界行为维持原状。A2A src 内没有 ParseHeadersAndBody 的生产调用点,其客户端走独立解析路径,因此无需为该 helper 适配额外 A2A 调用方。
参考:RFC 9110 §8.6、RFC 9112 §6.3。