httpclient 在 callable 中应复用 closeablehttpclient 实例并配置连接池，为每个请求单独设置超时，用 completablefuture.supplyasync 封装调用，异常时显式关闭响应实体并正确抛出。
在 Callable 中使用 HttpClient 发送并发请求，关键不是“能不能用”，而是“怎么用得安全、可控、不泄漏、易管理”。HttpClient 本身是线程安全的（只要不共享可变状态），但直接 new HttpClient 每次都创建，既低效又容易耗尽资源；而粗暴共享一个实例又可能因连接池配置不当导致超时或阻塞。优雅的核心在于：复用、隔离、可取消、有超时。
用 CloseableHttpClient + 连接池管理生命周期
HttpClient 5.x 推荐使用 CloseableHttpClient，它支持连接池（PoolingHttpClientConnectionManager），能复用 TCP 连接、控制最大并发数和空闲回收。Callable 里不应自己 new 实例，而应通过依赖注入或静态工厂获取已配置好的客户端。
- 定义一个单例或 Spring Bean 级别的
CloseableHttpClient，配置合理的 max total / max per route、keep alive 时间和超时策略 - 在 Callable 的
call()方法中直接调用client.execute(request)，无需额外同步 - 注意：不要在 Callable 里调用
close()—— 它属于全局资源，由应用生命周期统一管理
为每个请求设置独立超时与上下文
并发场景下，某个请求卡住不该拖垮整个线程池。必须为每个请求单独指定超时，避免阻塞 Callable 所在线程。
- 用
RequestConfig.custom()设置 connectTimeout、socketTimeout 和 connectionRequestTimeout - 把 RequestConfig 绑定到 HttpGet/HttpPost 实例上，而不是依赖 client 全局默认值
- 可选：通过
HttpContext传递追踪 ID 或用户凭证，便于日志关联和权限隔离
配合 CompletableFuture 实现非阻塞组合
单纯用 ExecutorService 提交一堆 Callable 是可行的，但若需“等全部完成”“任一成功即返回”“失败自动降级”，建议用 CompletableFuture.supplyAsync() 包装 HttpClient 调用，并显式指定自定义线程池（避免占用 ForkJoinPool）。
- 把 HttpClient 调用封装成 Supplier，用 supplyAsync 提交，天然支持 thenApply / exceptionally / handle
- 线程池建议用
new ThreadPoolExecutor显式构造，核心/最大线程数匹配后端 QPS 和连接池大小 - 调用
future.get(timeout, unit)保证 Callable 不无限等待；超时后记得 cancel(true) 中断底层 I/O
异常处理与连接释放要闭环
HttpClient 抛出的异常类型多（IOException、HttpHostConnectException、TimeoutException 等），且响应实体（HttpEntity）必须显式关闭，否则连接无法归还池中。
- 务必在 finally 块或 try-with-resources 中调用
entity.getContent().close()（或使用EntityUtils.consumeQuietly(entity)） - 捕获
IOException和ExecutionException分开处理：网络异常重试，业务异常转译 - 避免在 Callable 中吞掉异常或只打印日志——要向上抛出或包装为 RuntimeException，让 Future 或 CompletableFuture 正确感知失败
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
