Apache连接数溢出实为HttpClient连接池耗尽，需监控活跃连接数、待分配请求数、租用超时次数及平均获取耗时；通过Micrometer接入Prometheus并配置分级告警，结合参数调优与连接关闭规范实现防护。
Apache连接数溢出通常不是指 Apache HTTP Server 本身，而是指 Java 应用中使用 Apache HttpClient（如 HttpClient、PoolingHttpClientConnectionManager）时，连接池耗尽导致请求阻塞或超时，最终引发服务不可用。监控与报警的关键在于：及时发现连接池满、连接获取超时、连接泄漏等行为。
监控核心指标
需在应用层埋点并采集以下关键指标：
- 活跃连接数（leased connections）：当前已被分配、正在使用的连接数量；持续接近最大连接数（如 maxTotal=200），说明连接未及时释放或并发突增
- 待分配连接数（pending requests）：等待从连接池获取连接的请求数；非零值且持续增长，代表连接池已饱和，后续请求将排队或失败
-
连接获取超时次数（lease timeout count）：调用
connectionManager.leaseConnection()超时的频次；该值上升是服务即将雪崩的明确信号 - 平均连接获取耗时：正常应为毫秒级；若升至数百毫秒甚至秒级，说明连接池争用严重
接入 Prometheus + Grafana 实现可视化
通过 Micrometer 或自定义 HttpClientBuilder 注入指标收集逻辑：
- 使用
PoolingHttpClientConnectionManager时，调用其getTotalStats()和getStats(HttpRoute)方法定期上报指标 - 暴露为 Prometheus 格式端点（如
/actuator/prometheus），新增指标如：httpclient_pool_leased_connections{route="https://api.example.com:443"}httpclient_pool_pending_requests{route="https://api.example.com:443"}httpclient_pool_lease_timeout_total{route="https://api.example.com:443"} - Grafana 中配置告警看板，重点关注「pending > 5 且持续 1 分钟」或「leased == maxTotal 持续 30 秒」等条件
设置有效报警规则
避免误报和漏报，推荐以下分级告警策略：
立即学习“Java免费学习笔记（深入）”；
- 预警（Warning）：leased 连接数 ≥ 80% maxTotal，且持续 2 分钟 → 检查下游依赖响应变慢或连接泄漏
- 严重（Critical）：pending requests > 0 并持续 30 秒，或 lease_timeout_total 5 分钟内增长 ≥ 10 次 → 立即触发值班通知
-
关联检查项：报警同时拉取 JVM 线程堆栈（
jstack）、GC 日志、下游接口 P99 延迟，确认是否因远程慢调用阻塞连接未释放
自动防护与兜底建议
光靠监控不够，需配合运行时防护：
- 为
PoolingHttpClientConnectionManager设置合理参数：setMaxTotal(200)、setDefaultMaxPerRoute(50)、setConnectionTimeToLive(30, TimeUnit.SECONDS)、setValidateAfterInactivity(5000) - 启用连接泄露检测（仅限测试/预发）：
setValidateAfterInactivity(1000)+ 自定义ConnFactory记录创建堆栈，辅助定位未关闭的CloseableHttpResponse - 业务代码强制使用 try-with-resources 或显式
response.close()，避免连接长期占用
