如何配置Tomcat的acceptCount参数

SE_Yang

2026-1-4

想要配置 Tomcat 的 acceptCount 参数，这个参数是控制请求等待队列长度的核心配置，直接影响高并发场景下 Tomcat 对「线程池满后请求」的处理能力。下面我会从配置方法、参数原理、调优原则、验证方式等方面，给你清晰且可落地的指导。

一、先理解 acceptCount 核心作用

acceptCount 定义：当 Tomcat 工作线程池（maxThreads）被占满时，新请求会进入「等待队列」，acceptCount 就是这个队列的最大长度。
触发逻辑：
1. 并发请求数 ≤ maxThreads → 直接分配线程处理；
2. maxThreads < 并发请求数 ≤ maxThreads + acceptCount → 新请求进入队列等待；
3. 并发请求数 > maxThreads + acceptCount → Tomcat 直接拒绝新请求（返回 Connection refused）。
默认值：100（仅适用于测试 / 低并发场景，生产需调整）。

二、配置方法（2 种核心场景）

方式 1：外置 Tomcat（修改 server.xml，推荐生产环境）

这是最常用的方式，直接在 Connector 标签中配置 acceptCount：

打开 Tomcat 安装目录下的 conf/server.xml；
找到 <Connector> 标签，添加 / 修改 acceptCount 参数（需和 maxThreads 配套）：

xml

<Service name="Catalina">
    <Connector 
        port="8080"                  <!-- 监听端口 -->
        protocol="org.apache.coyote.http11.Http11NioProtocol"  <!-- NIO 模型（生产首选） -->
        maxThreads="800"             <!-- 最大工作线程数 -->
        minSpareThreads="50"         <!-- 核心线程数 -->
        acceptCount="500"            <!-- 等待队列长度（核心配置） -->
        maxConnections="20000"       <!-- NIO 模式最大连接数 -->
        connectionTimeout="30000"    <!-- 连接超时 -->
        URIEncoding="UTF-8"          <!-- 避免中文乱码 -->
    />
    <Engine name="Catalina" defaultHost="localhost">
        <!-- 其他配置 -->
    </Engine>
</Service>

保存后重启 Tomcat（该参数不支持热加载，必须重启生效）。

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

若使用 Spring Boot 内嵌 Tomcat，无需修改 server.xml，直接通过配置文件或代码配置：

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

yaml

# application.yml
server:
  port: 8080
  connection-timeout: 30s
  tomcat:
    threads:
      max: 800        # 对应 maxThreads
      min-spare: 50   # 对应 minSpareThreads
    accept-count: 500 # 对应 acceptCount（核心配置）
    max-connections: 20000 # 对应 maxConnections

properties

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

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

java

运行

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();
            // 配置 acceptCount
            protocol.setAcceptCount(500);
            // 配套配置
            protocol.setMaxThreads(800);
            protocol.setMinSpareThreads(50);
            protocol.setMaxConnections(20000);
            protocol.setConnectionTimeout(30000);
        });
        return factory;
    }
}

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

acceptCount 并非越大越好，需结合 maxThreads、服务器硬件、业务请求耗时综合调整，核心原则：

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

服务器配置	maxThreads 推荐值	acceptCount 推荐值	说明
2 核 4G（轻量应用）	200~400	200~300	队列过长会增加请求等待时间
4 核 8G（常规生产）	500~800	500~800	平衡队列长度和响应时间
8 核 16G（高并发）	1000~1500	800~1000	高并发下适度增加队列缓冲

2. 关键调优逻辑

和 maxThreads 配套：acceptCount 建议为 maxThreads 的 0.5~1 倍（如 maxThreads=800 → acceptCount=500~800）；
IO 密集型业务：可适当调大（如 maxThreads=800 → acceptCount=800），因为 IO 等待时线程空闲快，队列请求能快速被处理；
CPU 密集型业务：需调小（如 maxThreads=800 → acceptCount=400），避免队列请求等待过久导致响应超时；
避免过度配置：acceptCount 过大（如超过 1000）会导致请求排队时间过长（甚至超过 connectionTimeout），用户感知为「页面卡顿 / 接口超时」。

四、验证 acceptCount 配置是否生效

方式 1：查看 Tomcat 启动日志

外置 Tomcat 启动后，在 logs/catalina.out 中搜索 acceptCount：

plaintext

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.setAcceptCount Setting acceptCount to 500

Spring Boot 内嵌 Tomcat 启动日志：

plaintext

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

方式 2：压测验证（推荐）

用 JMeter 模拟高并发请求（请求数 > maxThreads），观察：

请求数 ≤ maxThreads + acceptCount → 请求正常进入队列，等待后被处理；
请求数 > maxThreads + acceptCount → 部分请求被拒绝（返回 Connection refused）；
若队列中请求等待时间超过 connectionTimeout → 需调小 acceptCount 或调大 maxThreads。

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

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

xml

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

访问 http://localhost:8080/manager/html，登录后查看「Thread Pool」模块，可看到 acceptCount 配置值和当前队列等待数。

五、常见问题与解决方案

问题现象原因解决方案

高并发下大量请求被拒绝

acceptCount/maxThreads 过小

问题现象	原因	解决方案
高并发下大量请求被拒绝	acceptCount/maxThreads 过小	1. 调大 acceptCount（如从 100 到 500）； 2. 调大 maxThreads； 3. 升级服务器配置
请求排队时间过长（超时）	acceptCount 过大，队列请求等待过久	1. 调小 acceptCount； 2. 调大 maxThreads； 3. 优化业务代码减少请求处理耗时
配置 acceptCount 不生效	1. 配置位置错误（未写在 Connector 标签）； 2. 未重启 Tomcat； 3. Spring Boot 配置项写错	1. 检查 server.xml 中 Connector 标签； 2. 重启 Tomcat； 3. Spring Boot 确认配置项为 `server.tomcat.accept-count`

1. 调大 acceptCount（如从 100 到 500）；

2. 调大 maxThreads；

3. 升级服务器配置

请求排队时间过长（超时）

acceptCount 过大，队列请求等待过久

1. 调小 acceptCount；

2. 调大 maxThreads；

3. 优化业务代码减少请求处理耗时

配置 acceptCount 不生效

1. 配置位置错误（未写在 Connector 标签）；

2. 未重启 Tomcat；

3. Spring Boot 配置项写错

1. 检查 server.xml 中 Connector 标签；

2. 重启 Tomcat；

3. Spring Boot 确认配置项为 server.tomcat.accept-count

总结

acceptCount 是 maxThreads 的「缓冲兜底」，核心作用是避免高并发下请求直接被拒绝；
配置时需和 maxThreads 配套，按服务器硬件、业务类型（IO/CPU 密集）调整，避免过大 / 过小；
生产环境需通过压测验证配置合理性，核心指标是「请求拒绝率」和「平均响应时间」；
推荐生产配置（4 核 8G，IO 密集型）：maxThreads=800 + acceptCount=500 + maxConnections=20000。

阅读剩余

作者：SE_Yang

链接：https://www.cnesa.cn/10455.html

文章版权归作者所有，未经允许请勿转载。

THE END

通过Docker安装带完整图形化管理功能的旧版MinIO

<<上一篇

锐捷接入交换机管理vlan ping不通核心

下一篇>>

阿里云ECS特惠活动

阿里云ECS服务器 - 限时特惠活动