Mockito创建Mock时同名类加载异常的原因及解决方法

问题原因 #

出现这个问题的核心是类加载器的类查找逻辑+全限定名冲突：

1. 项目的com.project.ClassA和第三方库的同名类，由不同类加载器加载，在JVM里属于完全不同的类。
2. Mockito生成Mock时依赖ByteBuddy的MultipleParentClassLoader，这个类加载器在查找父类（也就是你要Mock的ClassA）时，可能优先从第三方库的类路径中找到了同名类，导致生成的Mock类继承了错误的ClassA，最终抛出类型转换异常。
3. 部分构建工具的依赖顺序也可能导致类加载优先级异常，第三方库的类被先加载，覆盖了项目自身的类引用。

解决方法 #

1. 指定Mock使用目标类的类加载器 #

创建Mock时，显式指定使用com.project.ClassA自身的类加载器，确保ByteBuddy生成的Mock类基于正确的父类：

import com.project.ClassA;
import org.mockito.Mockito;

ClassA classA = Mockito.mock(ClassA.class, Mockito.withSettings().classLoader(ClassA.class.getClassLoader()));

2. 调整构建依赖顺序 #

在Maven/Gradle中，把项目自身的代码模块依赖放在第三方库依赖之前，让类加载器优先加载项目内的com.project.ClassA：

• Maven：在<dependencies>中，项目模块依赖写在第三方库依赖上方
• Gradle：将项目模块的implementation声明放在第三方库依赖之前

3. 排除冲突的第三方依赖 #

如果第三方库中的com.project.ClassA是无关的冗余类，直接在构建工具中排除该依赖：

• Maven示例：

<dependency>
    <groupId>第三方库groupId</groupId>
    <artifactId>第三方库artifactId</artifactId>
    <version>版本号</version>
    <exclusions>
        <exclusion>
            <groupId>com.project</groupId>
            <artifactId>可能的artifactId</artifactId>
        </exclusion>
    </exclusions>
</dependency>

• Gradle示例：

implementation('第三方库groupId:第三方库artifactId:版本号') {
    exclude group: 'com.project', module: '可能的module'
}

4. 显式使用全限定名引用 #

在测试代码中，直接用全限定名声明变量和Mock目标，避免编译时的类引用混淆：

com.project.ClassA classA = Mockito.mock(com.project.ClassA.class);

内容的提问来源于stack exchange，提问作者Pratim Singha