Tomcat 的 Connector（连接器）是处理客户端 HTTP 连接的核心组件，负责监听端口、解析协议、管理线程池等，其配置直接影响 Tomcat 的性能、兼容性和安全性。以下是 Connector 的核心配置方式、关键参数、常见场景配置，基于 Tomcat 8/9/10 版本（主流版本）讲解。
一、核心配置位置
Connector 的配置主要在 Tomcat 安装目录下的
conf/server.xml 文件中，嵌套在 <Service> 标签内（一个 Service 可配置多个 Connector，对应不同端口 / 协议）。基础配置模板：
xml
<Service name="Catalina">
<!-- 核心 Connector 配置 -->
<Connector
port="8080" <!-- 监听端口 -->
protocol="org.apache.coyote.http11.Http11NioProtocol" <!-- IO 模型 -->
connectionTimeout="20000" <!-- 连接超时时间 -->
maxThreads="200" <!-- 最大线程数 -->
minSpareThreads="10" <!-- 核心线程数 -->
acceptCount="100" <!-- 等待队列长度 -->
URIEncoding="UTF-8" <!-- URI 编码 -->
redirectPort="8443" <!-- HTTPS 重定向端口 -->
/>
<Engine name="Catalina" defaultHost="localhost">
<!-- Engine/Host/Context 配置 -->
</Engine>
</Service>
二、Connector 核心配置参数（按优先级分类）
1. 基础通信参数（必配）
| 参数名 | 作用 | 默认值 | 建议值 |
|---|---|---|---|
port |
监听的 TCP 端口（如 8080），设为 0 则随机分配端口 |
8080 | 8080/80（需权限） |
protocol |
IO 模型 / 协议类型，决定 Connector 的底层通信方式 | Http11NioProtocol | 见「IO 模型配置」 |
connectionTimeout |
连接超时时间（ms），超过则关闭连接（避免空闲连接占用资源） | 20000 | 20000~30000 |
URIEncoding |
解析请求 URI 的编码格式（解决中文乱码） | ISO-8859-1 | UTF-8 |
redirectPort |
当请求需要 HTTPS 时，重定向到的端口（需配合 SSL Connector） | 8443 | 443 |
2. 线程池参数（性能核心）
Tomcat 通过线程池处理请求，参数配置直接影响并发能力：
| 参数名 | 作用 | 默认值 | 调优建议 |
|---|---|---|---|
maxThreads |
最大工作线程数（处理请求的线程上限） | 200 | 按服务器核心数调整：4 核 8G → 500~800；8 核 16G → 1000~1500 |
minSpareThreads |
核心线程数（保持常驻的线程数，避免频繁创建 / 销毁） | 10 | 50~100（根据最小并发量） |
acceptCount |
请求等待队列长度（线程池满时，请求进入队列等待） | 100 | 200~500（队列过长会增加响应时间，需平衡） |
maxConnections |
最大连接数（NIO 模式下，允许同时存在的连接数，超过则放入队列） | 10000 | 20000~50000（高并发场景） |
threadPriority |
工作线程优先级（1~10，10 最高） | 5 | 5（无需调整） |
3. HTTPS/SSL 配置（安全场景）
若需支持 HTTPS，需配置 SSL 相关参数（需先生成证书）：
xml
<Connector
port="8443"
protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" <!-- 开启 SSL -->
scheme="https" <!-- 协议标识 -->
secure="true" <!-- 标记为安全连接 -->
keystoreFile="conf/localhost-rsa.jks" <!-- 证书文件路径 -->
keystorePass="changeit" <!-- 证书密码 -->
keyAlias="localhost-rsa" <!-- 证书别名 -->
sslProtocol="TLS" <!-- SSL 协议版本 -->
ciphers="TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,..." <!-- 加密套件 -->
/>
4. 高级优化参数（可选）
| 参数名 | 作用 | 适用场景 | |
|---|---|---|---|
compression |
开启 HTTP 压缩（on/off/force），减少传输数据量 |
高带宽消耗场景（如返回大文本） | |
compressionMinSize |
触发压缩的最小响应大小（字节） | 2048（仅压缩大于 2K 的响应） | |
enableLookups |
是否反向解析客户端 IP 为主机名（关闭可提升性能） | true | false（生产环境） |
maxKeepAliveRequests |
长连接最大请求数（HTTP/1.1 长连接） | 100 | 500~1000（提升长连接复用率） |
keepAliveTimeout |
长连接空闲超时时间（ms） | 60000 | 30000（避免长连接占用资源） |
三、关键场景配置示例
场景 1：高性能 NIO 模型配置（生产环境首选）
Tomcat 8+ 默认使用 NIO 模型，适合高并发场景：
xml
<Connector
port="8080"
protocol="org.apache.coyote.http11.Http11NioProtocol" <!-- NIO 模型 -->
connectionTimeout="30000"
maxThreads="800" <!-- 4核8G 服务器建议值 -->
minSpareThreads="50"
acceptCount="500"
maxConnections="20000" <!-- 最大并发连接数 -->
URIEncoding="UTF-8"
enableLookups="false" <!-- 关闭IP反向解析 -->
compression="on" <!-- 开启压缩 -->
compressionMinSize="2048"
maxKeepAliveRequests="500" <!-- 长连接最大请求数 -->
keepAliveTimeout="30000"
/>
场景 2：HTTPS/SSL 配置（安全访问）
- 生成 SSL 证书（JDK
keytool工具）：bash运行keytool -genkey -alias localhost-rsa -keyalg RSA -keysize 2048 -validity 3650 -keystore conf/localhost-rsa.jks - 配置 HTTPS Connector：
xml
<Connector port="443" <!-- HTTPS 默认端口 --> protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true" scheme="https" secure="true" keystoreFile="conf/localhost-rsa.jks" <!-- 证书路径 --> keystorePass="123456" <!-- 证书密码 --> keyAlias="localhost-rsa" sslProtocol="TLS" ciphers="TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384" URIEncoding="UTF-8" maxThreads="800" acceptCount="500" />
场景 3：多端口监听（不同协议 / 用途）
一个 Service 可配置多个 Connector，监听不同端口：
xml
<Service name="Catalina">
<!-- 8080 端口：HTTP 普通请求 -->
<Connector port="8080" protocol="Http11NioProtocol" .../>
<!-- 8443 端口：HTTPS 安全请求 -->
<Connector port="8443" protocol="Http11NioProtocol" SSLEnabled="true" .../>
<!-- 8009 端口：AJP 协议（对接 Apache 服务器） -->
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443"/>
</Service>
四、IO 模型选择（protocol 参数）
protocol 参数决定 Connector 的底层 IO 模型，不同模型性能差异显著：| protocol 值 | IO 模型 | 特点 | 适用场景 |
|---|---|---|---|
org.apache.coyote.http11.Http11NioProtocol |
NIO | 非阻塞 IO，Reactor 模式，少量线程处理大量连接，性能高 | 生产环境（默认） |
org.apache.coyote.http11.Http11Nio2Protocol |
NIO2/AIO | 异步 IO，基于 JDK AIO，性能略优于 NIO（依赖操作系统支持） | 高并发场景（Linux 服务器） |
org.apache.coyote.http11.Http11AprProtocol |
APR | 基于本地库的 IO 模型，性能最优（需安装 APR 库） | 超高性能要求的生产环境 |
HTTP/1.1（等价于 Http11Protocol） |
BIO | 阻塞 IO，一个连接占用一个线程，性能低 | 测试 / 低并发场景 |
配置建议：生产环境优先用
Http11NioProtocol，Linux 服务器可升级为 Http11Nio2Protocol 或 Http11AprProtocol。五、配置生效与验证
1. 生效方式
修改
server.xml 后，重启 Tomcat 即可生效（Tomcat 不支持 Connector 配置热加载）。2. 验证配置
- 端口监听：执行
netstat -tlnp | grep 8080，确认端口已监听； - HTTPS 验证：访问
https://localhost:443，确认证书正常加载； - 线程池验证：通过 Tomcat 管理端（
http://localhost:8080/manager/html）查看线程池状态； - 乱码验证：访问含中文参数的 URL（如
http://localhost:8080/demo?name=张三），确认解析正常。
六、常见配置问题与解决方案
| 问题现象 | 原因 | 解决方案 |
|---|---|---|
| 端口占用 | 配置的 port 已被其他进程占用 | 更换 port（如 8081），或杀死占用进程 |
| 中文乱码 | URIEncoding 未设为 UTF-8 | 配置 URIEncoding="UTF-8" |
| 高并发下请求被拒绝 | maxThreads/acceptCount 过小 | 调大 maxThreads（如 800）和 acceptCount（如 500） |
| HTTPS 访问失败 | 证书路径 / 密码错误，或 SSL 协议不兼容 | 检查 keystoreFile/keystorePass，配置 sslProtocol="TLS" |
| 长连接占用资源 | keepAliveTimeout 过长 | 缩短 keepAliveTimeout（如 30000ms），降低 maxKeepAliveRequests |
七、核心总结
Connector 配置的核心是「基础通信 + 线程池调优 + 场景适配」：
- 基础参数保证通信正常（端口、编码、超时）；
- 线程池参数决定并发能力（按服务器配置调整 maxThreads/maxConnections）；
- 场景适配（HTTPS、压缩、IO 模型）提升安全性和性能；
- 生产环境优先选择 NIO/NIO2/APR 模型，关闭不必要的功能（如 enableLookups）。
合理配置 Connector 是 Tomcat 性能优化的第一步，需结合业务并发量、服务器资源、安全要求综合调整。