Apache HttpClient 通过连接池管理与上层限流实现单客户端并发限制：基础层用 PoolingHttpClientConnectionManager 设 maxTotal 和 defaultMaxPerRoute；进阶方案为各客户端分配独立连接池或使用 Semaphore；Spring 环境推荐 Resilience4j Bulkhead 隔离，并配合 RequestScope 动态识别 clientKey。
Apache HttpClient 本身不直接提供“单客户端并发连接数限制”功能，但可以通过 连接池管理 和 请求调度控制 实现等效效果，防止某个客户端（如某个用户、IP 或业务逻辑单元）耗尽整个连接池资源。
使用 PoolingHttpClientConnectionManager 控制总连接上限
这是最基础的防护层。通过设置连接池最大总数和每个路由最大连接数，避免全局资源被单点占满：
- setMaxTotal(100)：整个连接池最多维持 100 个活跃连接
- setDefaultMaxPerRoute(20)：默认每个 host:port 最多 20 个连接（例如对 api.example.com 最多 20 个）
- 若需区分客户端，需配合上层逻辑（如按 IP 或 token 分组），ConnectionManager 本身不识别“客户端”概念
按客户端维度实现并发限流（推荐方案）
真正限制“单客户端”的并发数，需在 HttpClient 调用前加一层轻量级限流器。常用做法是为每个客户端分配独立的连接池 + 信号量：
- 用 ConcurrentHashMap<String, CloseableHttpClient> 按 clientKey（如 userId / IP）缓存专属 HttpClient 实例
- 每个实例绑定独立的 PoolingHttpClientConnectionManager，并设 setMaxTotal(5)（即该客户端最多 5 并发）
- 或更轻量：用 Semaphore 在执行请求前 acquire()，成功后 execute，finally 中 release()
结合 Spring Boot 的实用配置示例
若项目基于 Spring，可通过 @Bean 定义带限流能力的 RestTemplate 或 WebClient：
立即学习“Java免费学习笔记（深入）”；
- 定义 HttpClient 时启用连接池，并关闭 keep-alive 超时滥用：
setConnectionTimeToLive(30, TimeUnit.SECONDS) - 使用 Resilience4j 的 Bulkhead（舱壁模式）隔离客户端调用，硬性限制并发数
- 配合 @RequestScope Bean，在 Web 层按请求提取 clientKey（如 Header 中的 X-User-ID），动态选择限流策略
注意反模式：仅靠超时不能防并发爆炸
设置 socketTimeout 或 connectionRequestTimeout 只影响单次等待，无法阻止大量请求同时进入连接获取队列。若不控制入口并发，连接池排队会持续增长，最终 OOM 或线程饥饿。必须在请求发起前做准入控制。
