Tomcat 连接与线程参数调优：maxThreads、acceptCount 与 KeepAlive

高峰期请求打到 Tomcat 后，会经过连接建立、accept 队列、工作线程处理等阶段。maxThreads、acceptCount、connectionTimeout 设置不当，会造成排队、拒绝或线程耗尽。

解决方案思路

根据 CPU、接口耗时和下游容量设置 maxThreads；acceptCount 作为短时缓冲，不要当无限队列；KeepAlive 时间要匹配网关和客户端，避免空闲连接占满资源。

Tomcat 参数示例

server:
  tomcat:
    threads:
      max: 300
      min-spare: 20
    accept-count: 200
    connection-timeout: 3s
    keep-alive-timeout: 15s

运行逻辑

请求进入连接队列后等待工作线程处理。线程数不是越大越好，慢 SQL、慢 HTTP 调用会让工作线程长期占用，所以 Tomcat 参数必须和下游限流、连接池一起看。

重点观察指标

• Tomcat busy threads、current connections
• 网关 502/504、连接拒绝数
• 接口 P99、CPU 与线程上下文切换

常见误区

• 把 acceptCount 当容量扩展手段
• maxThreads 大于下游可承载容量太多
• 没有统一网关、Tomcat、客户端超时

参考方案

• Tomcat HTTP Connector

上线检查

• 优化前后保留同一口径的指标截图或报告。
• 先灰度单实例或小流量，观察 P95/P99、错误率和资源指标。
• 准备回滚开关，避免性能改动影响核心业务。