海外用户访问国内API时，连接复用能减少重复建连，但跨境链路的延迟和波动也会让连接占用时间变长。配置“海外用户访问国内API的连接池参数配置”，应从实际并发、接口时限和服务端限制出发，而不是把连接数一味调高。
先弄清连接数为何会被占满
连接池限制的是可复用或正在使用的连接，不等于请求数上限。以 HTTP/1.1 为例，单条连接通常一次处理一个在途请求；HTTP/2 可在一条连接上并发多个数据流，连接数与并发请求数的关系因此不同。还要留意客户端是否按目标主机分别设池，以及服务端是否限制连接数。
可用“在途请求数 ≈ 每秒请求数 × 请求平均耗时”做初步估算。例如，某接口稳定处理每秒约 20 个请求、平均耗时约 1 秒，平均在途量约为 20；突发并发、长尾耗时和重试都会抬高峰值，因此还需结合监控留出余量。这个估算不是固定容量答案。
五项参数，逐一对应瓶颈
- 单主机最大连接数：决定同一目标可同时占用多少连接。先按峰值在途量估算，再小步增加；若连接上限经常打满、等待时间上升，才考虑扩容。盲目设得很大，可能增加客户端资源消耗，也可能触及服务端限制。
- 空闲连接上限与保留时长：前者控制连接复用数量，后者决定空闲多久后清理。可以先让空闲连接上限约为最大连接数的 10%–30%，再根据请求频率和服务端空闲关闭策略调整。低频接口保留太久会积累失效连接；清理太快则会频繁重新建连。
- 获取连接等待超时：请求在池中等不到空闲连接时，最多等待多久。可先设为接口总时限的一小部分，例如约 0.5–2 秒作为排查起点；若频繁超时，检查池容量和请求耗时，不要只延长等待时间。
- 建连超时：限定建立新连接所允许的时间。可先用约 3–10 秒做试运行范围，再按不同地区的连接耗时分位数调整；网络抖动较大时应通过实际观测决定，而非直接设为很长。
- 读取或整体请求超时：读取超时限制等待响应数据的时间，整体超时则覆盖请求全过程，具体名称因客户端库而异。应以接口SLA和实测长尾为依据，并确保整体时限大于合理的建连、排队与服务处理预算。过短会误杀慢请求，过长会让连接和调用线程被占用。
按顺序调参，避免把超时当成容量问题
- 按海外用户所在地区和目标API分别采集请求量、在途数、连接池等待时间、连接错误率及耗时分位数。不要只看平均值，尤其要关注高分位耗时。
- 确认客户端复用已启用，并核对协议版本、单主机连接上限和服务端限制。Java Apache HttpClient 与 Go 的 net/http 都提供连接复用相关设置，但参数名称和默认行为并不完全相同。
- 先调整连接上限与空闲策略，再分别测试获取连接、建连和读取超时。每次只改一组参数，用相同地区、相近请求负载对比等待时间、错误率和资源占用。
- 若连接池等待升高但服务端响应正常，可小幅增加上限；若建连超时上升，优先排查链路和连接建立过程；若读取超时集中于特定接口，则核对接口耗时与时限预算。
常见问题
连接池越大，吞吐就越高吗？
不一定。服务端、客户端线程和网络都有容量边界；池过大可能增加资源占用，甚至加重服务端压力。
海外用户是否应统一设置更长超时？
不建议。不同地区、接口和时限预算有差异，应根据分地区观测设置，并为整体请求设定明确上限。
池等待超时和建连超时能互相替代吗？
不能。前者是等待可用连接，后者是建立新连接；分开监控才能判断瓶颈在哪里。
最终，海外用户访问国内API的连接池参数配置应以测得的并发和耗时为依据，逐项验证五类设置，并在流量变化或服务端策略调整后复查。