从TomEE8+Spring5迁移到TomEE9+Spring6时Mock组件测试问题

问题现象 #

项目从TomEE 8、Spring 5迁移至TomEE 9、Spring 6后，运行测试时触发异常：

java.lang.NoClassDefFoundError: jakarta/servlet/ServletConnection

核心原因是Spring的MockHttpServletRequest等Mock组件依赖Servlet 6.0.0新增的jakarta.servlet.ServletConnection类，但当前测试环境无法找到该类。

根因分析 #

• TomEE 9基于Tomcat 10.0和Jakarta EE 9.1，仅提供Servlet 5.0版本，不存在ServletConnection类；
• Spring 6.0虽最低兼容Jakarta EE 9（Servlet 5.0），但其Mock测试组件是以Servlet 6.0 API为基准开发的，测试类路径必须提供Servlet 6.0 API；
• 项目依赖jakarta.jakartaee-bom:9.1.0，该BOM锁定了Servlet 5.0版本，导致测试时无法获取Servlet 6.0的类定义。

解决方案 #

1. Maven测试阶段单独引入Servlet 6.x（推荐） #

通过Maven的test scope仅在测试时引入Servlet 6.0 API，生产环境仍使用TomEE 9自带的Servlet 5.0，完全规避部署风险。配置示例：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>jakarta.servlet</groupId>
            <artifactId>jakarta.servlet-api</artifactId>
            <version>6.0.0</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <!-- 其他业务/框架依赖 -->
    <dependency>
        <groupId>jakarta.servlet</groupId>
        <artifactId>jakarta.servlet-api</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

2. 迁移至支持Servlet 6.0的容器 #

升级到TomEE 10（基于Tomcat 10.1，兼容Jakarta EE 10/Servlet 6.0），让生产与测试环境的Servlet版本统一，彻底解决版本冲突。需提前评估容器迁移的适配成本。

3. 重构测试代码弃用Spring Mock组件 #

替换Spring Mock组件为其他测试方案，例如：

• 使用TomEE嵌入式容器进行真实环境集成测试；
• 改用第三方Mock框架模拟Servlet上下文。
  此方案重构成本较高，适合有测试架构调整需求的场景。

4. 临时覆盖Servlet版本（不推荐） #

直接在项目中强制覆盖Servlet版本为6.0.0，但生产部署时TomEE 9自带的Servlet 5.0会与该版本冲突，可能引发类加载异常、API兼容性问题，存在较高生产风险。

内容的提问来源于stack exchange，提问作者Simon Hill