如何配置Tomcat的maxThreads参数？

一、核心认知：maxThreads 是什么？

• 作用：Tomcat 通过线程池管理工作线程，maxThreads 是线程池的「上限」，当并发请求数超过该值时，新请求会进入 acceptCount 等待队列，队列满则直接拒绝请求。
• 默认值：Tomcat 8/9/10 默认 maxThreads=200（BIO 模型）/ maxThreads=200（NIO 模型，NIO 还需配合 maxConnections 控制总连接数）。
• 核心关联参数：
  • minSpareThreads：核心线程数（常驻线程，避免频繁创建 / 销毁）；
  • acceptCount：请求等待队列长度（线程池满时，请求排队的上限）；
  • maxConnections：NIO 模式下允许的最大连接数（超过则放入队列，与 maxThreads 配合控制并发）。

二、配置方法（2 种方式）

方式 1：修改 server.xml（全局配置，推荐）

1. 打开 Tomcat 安装目录下的 conf/server.xml；
2. 找到 <Connector> 标签，添加 / 修改 maxThreads 参数：

<Service name="Catalina">
    <!-- 核心 Connector 配置 -->
    <Connector 
        port="8080"                  <!-- 监听端口 -->
        protocol="org.apache.coyote.http11.Http11NioProtocol"  <!-- NIO 模型（生产首选） -->
        maxThreads="800"             <!-- 核心：最大工作线程数 -->
        minSpareThreads="50"         <!-- 核心线程数（建议为 maxThreads 的 1/10~1/5） -->
        acceptCount="500"            <!-- 等待队列长度（线程池满时，请求排队上限） -->
        maxConnections="20000"       <!-- NIO 模式下最大连接数（配合 maxThreads） -->
        connectionTimeout="30000"    <!-- 连接超时时间 -->
        URIEncoding="UTF-8"          <!-- 避免中文乱码 -->
    />
</Service>

3. 保存文件后，重启 Tomcat 使配置生效（Tomcat 不支持线程池参数热加载）。

方式 2：Spring Boot 内嵌 Tomcat 配置（代码 / 配置文件）

（1）application.yml/application.properties 配置（推荐）

# application.yml
server:
  tomcat:
    threads:
      max: 800        # 对应 maxThreads
      min-spare: 50   # 对应 minSpareThreads
    accept-count: 500 # 对应 acceptCount
    max-connections: 20000 # 对应 maxConnections
  port: 8080
  connection-timeout: 30000

# application.properties
server.tomcat.threads.max=800
server.tomcat.threads.min-spare=50
server.tomcat.accept-count=500
server.tomcat.max-connections=20000
server.port=8080
server.connection-timeout=30000

（2）代码自定义配置（灵活度更高）

import org.apache.catalina.connector.Connector;
import org.apache.coyote.http11.Http11NioProtocol;
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.servlet.server.ServletWebServerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class TomcatConfig {
    @Bean
    public ServletWebServerFactory tomcatServerFactory() {
        TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory();
        factory.addConnectorCustomizers((Connector connector) -> {
            Http11NioProtocol protocol = (Http11NioProtocol) connector.getProtocolHandler();
            // 配置 maxThreads
            protocol.setMaxThreads(800);
            // 配置核心线程数
            protocol.setMinSpareThreads(50);
            // 配置等待队列长度
            protocol.setAcceptCount(500);
            // 配置最大连接数（NIO 模式）
            protocol.setMaxConnections(20000);
            // 连接超时时间
            protocol.setConnectionTimeout(30000);
        });
        return factory;
    }
}

三、maxThreads 调优原则（核心！）

推荐 maxThreads = 服务器核心数 × (1 + 等待时间/处理时间)

1. 按服务器硬件配置（基础参考）

2. 按业务场景调整

• CPU 密集型业务（如计算、数据处理）：请求处理耗时短，等待时间少，maxThreads 不宜过大（接近核心数即可，避免线程上下文切换开销）；

  示例：4 核 8G 服务器，CPU 密集型 → maxThreads=400~600。

• IO 密集型业务（如数据库查询、接口调用）：请求处理时大量时间等待 IO，maxThreads 可适当调大（利用空闲 CPU 处理更多请求）；

  示例：4 核 8G 服务器，IO 密集型 → maxThreads=800~1000。

3. 结合 IO 模型

• BIO 模型（阻塞 IO）：一个连接占用一个线程，maxThreads 直接等于最大并发数，不宜超过 500（否则线程过多导致性能下降）；
• NIO/NIO2/APR 模型（非阻塞 / 异步 IO）：少量线程处理大量连接，maxThreads 可配合 maxConnections 调大（如 maxThreads=800 + maxConnections=20000）。

四、验证配置是否生效

方式 1：Tomcat 管理端（外置 Tomcat）

1. 配置 Tomcat 管理用户（修改 conf/tomcat-users.xml）：

<user username="admin" password="admin" roles="manager-gui,admin-gui"/>

2. 重启 Tomcat，访问 http://localhost:8080/manager/html，登录后查看「Thread Pool」模块：
   • 可看到 maxThreads、当前活跃线程数、空闲线程数等，确认配置值是否生效。

方式 2：日志验证

INFO [main] org.apache.coyote.http11.Http11NioProtocol.init Initializing ProtocolHandler ["http-nio-8080"]
INFO [main] org.apache.tomcat.util.net.NioEndpoint.bind Using address [0.0.0.0] and port [8080]
INFO [main] org.apache.tomcat.util.net.NioEndpoint.setMaxThreads Setting maxThreads to 800

方式 3：Spring Boot 内嵌 Tomcat 验证

o.apache.coyote.http11.Http11NioProtocol  : Initializing ProtocolHandler ["http-nio-8080"]
o.apache.tomcat.util.net.NioEndpoint      : maxThreads: 800, minSpareThreads: 50

五、常见问题与解决方案

六、最佳实践总结

1. 默认值仅用于测试：Tomcat 默认 maxThreads=200 仅适用于测试 / 低并发场景，生产环境必须根据服务器配置调整；
2. 配套参数需同步调整：调大 maxThreads 时，需同步调大 acceptCount（等待队列）和 minSpareThreads（核心线程），避免线程池频繁扩容；
3. NIO 模型是前提：生产环境优先使用 NIO/NIO2 模型，BIO 模型下 maxThreads 调大无意义；
4. 压测验证：配置后需通过 JMeter/LoadRunner 模拟高并发，观察 Tomcat 响应时间、CPU / 内存使用率，逐步调优；
5. 避免过度配置：maxThreads 超过服务器处理能力会导致线程上下文切换开销剧增，反而降低性能。

<!-- 外置 Tomcat server.xml -->
<Connector
    port="8080"
    protocol="org.apache.coyote.http11.Http11NioProtocol"
    maxThreads="800"
    minSpareThreads="50"
    acceptCount="500"
    maxConnections="20000"
    connectionTimeout="30000"
    URIEncoding="UTF-8"
/>

# Spring Boot application.yml
server:
  tomcat:
    threads:
      max: 800
      min-spare: 50
    accept-count: 500
    max-connections: 20000
  port: 8080
  connection-timeout: 30000