curl 8.22 恢复共享连接池上限：代理客户端升级测试
curl 8.22.0 于 2026 年 9 月 2 日发布，其中一项连接缓存修复会把 multi handle 的连接限制应用于使用共享池的传输。原始报告涉及 easy handle 通过 CURL_LOCK_DATA_CONNECT 共享连接时，CURLMOPT_MAX_HOST_CONNECTIONS 和 CURLMOPT_MAX_TOTAL_CONNECTIONS 的执行。
报告指出，在这种特定架构中，curl 8.13.0 至 8.21.0 可能没有实际执行已配置上限。这不表示所有 curl 用户都会超出连接数；应用必须同时使用 multi handle、设置连接上限，并采用 share handle 所有的连接池。但高并发代理客户端仍应把 8.22 当作容量控制变化进行验证。
为什么代理团队需要关注
连接上限不仅保护目标站，也能限制代理网关套接字、控制文件描述符和临时端口使用、平滑认证突发，并防止单一主机占满工作节点预算。
上限未生效时，可能看到：实际并发高于预期、代理 407 认证突发、目标或代理限流、源端口压力、不同目标之间不公平，以及升级后吞吐和成本突然改变。
不能只根据流量推断此问题，必须测量活跃连接，并复现相同的 share handle 架构。
识别受影响架构
盘点使用 libcurl multi 接口的应用。逐一记录 easy handle 是否共享连接数据、设置了哪些 multi 上限、多个 multi handle 是否共用同一 share handle，以及主要流量指向哪些代理网关和目标。
重点检查把 libcurl 配置隐藏在 HTTP 客户端、工作池或 SDK 后面的框架。记录运行时实际加载的 libcurl 版本；主机上的命令行 curl 可能不是同一个版本。
盘点表不得保存代理密码或会话令牌，只记录密钥引用和认证方式。
建立二维上限测试
使用获准代理与受控目标，分别设置较低且容易观察的单主机上限和总连接上限，再产生足够并行传输以超过两者。
至少测试四种形态：
- 一个目标经过一个代理网关；
- 多个目标经过一个代理网关；
- 一个目标经过多个代理端点；
- 多个 multi handle 共用同一共享连接池。
每种形态记录活跃连接数、排队传输、每秒完成量、p50/p95 延迟、代理认证次数、错误码、套接字数和实际出口。预期结果不只是“请求都成功”，还要证明峰值不超过上限，超额工作进入队列并在稍后完成。
在相同负载下比较版本
先用当前获批版本建立基线，再在灰度环境以 curl 8.22.0 重复测试。代理路由、目标、并发、超时、连接复用、DNS 模式和请求内容必须保持一致。
若旧版本曾超出配置上限，修复后的版本可能出现瞬时吞吐降低与排队增加。这可能是上限恢复执行的正确证据，而非性能回退。应根据原定资源与服务目标判断。
另加一组关闭连接共享的对照，以确认差异来自共享池路径，而不是代理、目标或压测器。
测试故障和恢复
连接失败时，上限也必须稳定执行。重启受控代理、使空闲连接失效、注入有界超时并轮换一个代理端点。确认死亡连接离开池、队列恢复处理，而且新建连接仍遵守两种上限。
代理失败后不得静默直连。可结合代理故障切换演练和临时端口耗尽排查，区分连接上限变化与恢复或本地网络故障。
用容量证据灰度上线
先选择少量工作节点，监控活跃代理连接、队列年龄、有效吞吐、尾延迟、认证率、重试放大和每个有效结果成本。只有在上限被遵守且队列能在业务目标内排空时，才扩大灰度。
不要因为排队增加就立即提高上限。先确认旧设置符合代理合同、目标规则、本地套接字预算和公平性要求。调整生产容量前，运行代理并发阶梯测试。
升级检查清单
- [ ] 已记录每个客户端运行时 libcurl 版本。
- [ ] 已盘点使用
CURL_LOCK_DATA_CONNECT的 multi/share handle。 - [ ] 单主机与总连接上限均有负责人。
- [ ] 测试负载能超过两种配置上限。
- [ ] 直接测量活跃连接和排队传输。
- [ ] 比较共享池与非共享池对照组。
- [ ] 验证代理认证、重试和出口路径。
- [ ] 故障恢复仍遵守两种上限。
- [ ] 已禁用并验证不会直连回退。
- [ ] 已定义灰度和回滚门槛。
常见问题
命令行 curl 默认受影响吗？
报告场景需要 libcurl 应用同时使用 multi handle 上限与共享连接池，简单的单次命令不一定符合该架构。
curl 8.22 会让工作负载变慢吗？
如果旧版本曾超过配置上限，瞬时并发会变化，队列可能增加。这可以是正确行为，应同时评估有效吞吐、排队时间与资源安全。
升级后应提高连接上限吗？
只有在获准容量测试后才能调整。上限可能保护代理合同、目标限制、本地端口和公平性，不应通过恢复失控并发来追求旧吞吐。
合规说明
只对自有或明确获准的代理账户和目标执行负载测试。遵守供应商并发限制、目标政策、隐私义务及速率限制，优先使用合成流量，不得借助连接共享规避访问控制。
研究说明：curl 项目《Changes in 8.22.0》，发布于 2026 年 9 月 2 日；curl 问题《CURLMOPT_MAX_HOST_CONNECTIONS is ignored with CURL_LOCK_DATA_CONNECT》，创建于 2026 年 7 月 4 日，并在版本发布前关闭。外部资料地址仅保存于内部运营记录。
