若依框架Tomcat升级指南与性能优化

1. 为什么若依框架需要升级Tomcat？

作为国内广泛使用的Java快速开发框架，若依（RuoYi）默认集成了Tomcat作为Web容器。但很多开发者容易忽略一个重要事实：框架初始版本集成的Tomcat往往不是最新稳定版。以当前主流若依4.7.6版本为例，其内置的Tomcat 9.0.34存在以下典型问题：

• CVE-2023-28708漏洞：旧版本存在请求走私风险，攻击者可构造恶意请求绕过安全限制
• 性能瓶颈：NIO处理器的epoll空轮询问题在9.0.34中未彻底修复，高并发时CPU占用率异常
• 特性缺失：不支持HTTP/2全双工通信，无法发挥现代浏览器的性能优势

我去年在金融项目中就遇到过真实案例：使用若依默认Tomcat时，当QPS超过800后出现线程阻塞，升级到Tomcat 10.0.27后性能提升40%。更重要的是，新版Tomcat对Spring Boot 2.7+的兼容性更好，能避免类加载冲突。

2. 升级前的关键准备工作

2.1 环境兼容性验证

在pom.xml中查看当前若依的Spring Boot版本：

xml复制<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.12</version> <!-- 注意此版本号 -->
</parent>

Tomcat版本选择原则：

• Spring Boot 2.4.x → Tomcat 9.0.x
• Spring Boot 2.5+ → Tomcat 10.0.x（推荐）
• Spring Boot 3.0+ → Tomcat 10.1.x

警告：不要直接升级到Tomcat 10.1.x与Spring Boot 2.x混用，会出现javax与jakarta命名空间冲突

2.2 依赖项检查

执行mvn dependency:tree | grep tomcat，典型输出应类似：

code复制[INFO] |  +- org.springframework.boot:spring-boot-starter-tomcat:jar:9.0.34:compile
[INFO] |  |  \- org.apache.tomcat.embed:tomcat-embed-core:jar:9.0.34:compile

记录所有tomcat相关依赖的当前版本，这是回滚时的关键依据。

3. 分步升级实操指南

3.1 修改POM文件

在若依项目的父pom.xml中覆盖Tomcat版本：

xml复制<properties>
    <tomcat.version>10.0.27</tomcat.version> <!-- 修改此处 -->
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-core</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
    </dependencies>
</dependencyManagement>

3.2 解决常见兼容性问题

问题1：javax.servlet包找不到
解决方案：在pom中添加：

xml复制<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>

问题2：WebSocket连接失败
修改若依的WebSocket配置类：

java复制@Bean
public ServletServerContainerFactoryBean createWebSocketContainer() {
    ServletServerContainerFactoryBean container = new ServletServerContainerFactoryBean();
    container.setMaxTextMessageBufferSize(8192);
    container.setMaxBinaryMessageBufferSize(8192);
    container.setMaxSessionIdleTimeout(15 * 60000L);
    return container;
}

4. 升级后验证与调优

4.1 基础功能测试清单

1. 文件上传下载：测试超过100MB的文件传输
2. WebSocket：模拟200个并发连接
3. 静态资源：检查CSS/JS加载是否完整
4. 会话管理：登录后跳转是否正常

4.2 性能调优参数

在application.yml中添加：

yaml复制server:
  tomcat:
    max-threads: 800
    min-spare-threads: 100
    connection-timeout: 20000
    max-connections: 10000
    accept-count: 200
    keep-alive-timeout: 30000

关键参数说明：

• max-threads = CPU核心数 * (1 + (等待时间/处理时间))
• 若依典型场景建议：4核CPU配800线程
• keep-alive-timeout超过30000ms可能导致TIME_WAIT堆积

5. 回滚方案与监控建议

5.1 快速回滚步骤

1. 还原pom.xml中的tomcat.version
2. 删除target目录
3. 执行mvn clean install -U
4. 重启应用时添加JVM参数：-Dtomcat.util.scan.StandardJarScanFilter.jarsToSkip=*

5.2 监控指标配置

在Prometheus中添加以下监控项：

yaml复制- name: tomcat_threads
  rules:
  - record: tomcat_threads_active
    expr: sum(tomcat_threads_active_total{instance=~"$instance"})
  - record: tomcat_sessions_active
    expr: sum(tomcat_sessions_active_total{instance=~"$instance"})

推荐告警阈值：

• 线程使用率 > 85%持续5分钟
• 会话数 > 2000持续10分钟

我在实际生产环境中发现，升级后的Tomcat 10.0.x版本需要特别关注NIO线程的阻塞情况。建议在Grafana中创建包含以下指标的看板：

• Tomcat线程池活跃线程数
• KeepAlive连接数
• 请求处理时间P99值
• 错误响应率（5xx）