Spring Boot升级至3.0.9后配置类CGLIB代理ClassCastException问题

问题核心 #

Spring Boot 3.0.4升级至3.0.9后，批量执行TestNG测试时出现CGLIB代理类的ClassCastException，单独执行或特定顺序执行测试则正常，本质是CGLIB代理类的类加载器冲突，多由依赖版本不一致、测试上下文缓存复用、类加载顺序异常导致。

具体解决方案 #

1. 统一CGLIB依赖版本 #

Spring Boot 3.0.9对CGLIB有明确的版本管理，先执行依赖树命令排查冲突：

• Maven：mvn dependency:tree | grep cglib
• Gradle：./gradlew dependencies | grep cglib

找到非Spring Boot管理的CGLIB依赖，在pom.xml或build.gradle中排除，确保全局使用Spring Boot提供的统一版本。

2. 调整测试上下文缓存策略 #

在失败的测试类上添加@DirtiesContext注解，强制测试结束后销毁上下文，避免跨测试类的上下文复用引发类加载冲突：

import org.springframework.test.annotation.DirtiesContext;
import org.springframework.test.context.testng.AbstractTestNGSpringContextTests;

@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS)
public class YourFailedTest extends AbstractTestNGSpringContextTests {
    // 测试代码
}

若大量测试类出现问题，也可在测试配置类中全局配置上下文销毁策略。

3. 切换至JDK动态代理（可选） #

若配置类实现了接口，可在application-test.properties中添加配置，强制使用JDK代理绕过CGLIB问题：

spring.aop.proxy-target-class=false

注意：若配置类未实现任何接口，此配置无效，Spring仍会使用CGLIB代理。

4. 调整TestNG执行顺序与并行设置 #

• 在TestNG的testng.xml中，将触发冲突的测试类设为优先执行，避免后续测试类复用已污染的上下文：

<suite name="YourSuite">
    <test name="PriorityTests">
        <classes>
            <class name="your.project.FailedTestClass"/>
            <!-- 其他测试类 -->
        </classes>
    </test>
</suite>

• 若开启了测试并行执行，暂时关闭并行（parallel="none"），排查是否因并行类加载导致冲突。

5. 升级TestNG版本 #

确保使用与Spring Boot 3.0.9兼容的TestNG版本（推荐7.7.0及以上），旧版TestNG与Spring测试上下文的类加载逻辑可能存在兼容性问题。

验证步骤 #

1. 清理项目依赖缓存（Maven：mvn clean install -U；Gradle：./gradlew clean build --refresh-dependencies）
2. 针对单个失败测试类添加@DirtiesContext验证是否解决问题
3. 逐步将解决方案推广至所有失败测试类

内容的提问来源于stack exchange，提问作者Petr Vraník