Mockito无法Mock类：接口初始化失败问题咨询

我是Mockito新手，尝试Mock模型类依赖的仓库来测试模型类，但所有仓库都触发了Mockito异常，异常信息如下：

Underlying exception : org.mockito.exceptions.base.MockitoException: Cannot instrument interface [...].CRUDRepositoryJPA because it or one of its supertypes could not be initialized
org.mockito.exceptions.base.MockitoException: 
Mockito cannot mock this class: class [..].BookRepository.

请问是否需要对接口进行额外处理或Mock？

相关代码 #

测试类 #

public class ModelTest{
    @Mock
    private BookRepository bookRepository = mock(BookRepository.class);
    // 其他字段

    @BeforeEach
    void setUp() {
        model = new ClientModel();

        when(bookRepository.readAll()).thenReturn(TestConfig.defaultBooks());
        // 其他mock设置

        model.readRepositories();
    }

    @Test
    // 测试方法
}

仓库类 #

public class BookRepository implements CRUDRepositoryJPA<Book> {
    // 实现代码
}

接口定义 #

public interface CRUDRepositoryJPA<T> extends CRUDRepository<T> {
    EntityManagerFactory emf = Persistence.createEntityManagerFactory(Config.DB_NAME);
}

public interface CRUDRepository<T> {
    void create(T t);
    Optional<T> readById(long id);
    List<T> readAll();
    void update(T t);
    void delete(T t);
}

测试依赖 #

testImplementation 'org.junit.jupiter:junit-jupiter-api:5.+'
testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.+'
testImplementation 'org.mockito:mockito-core:5.+'

系统环境 #

Java               : 19
JVM vendor name    : Amazon.com Inc.
JVM vendor version : 19.0.1+10-FR
JVM name           : OpenJDK 64-Bit Server VM
JVM version        : 19.0.1+10-FR
JVM info           : mixed mode
OS name            : Mac OS X
OS version         : 13.3

预期：仓库类可被Mock，调用readAll()完成模型初始化。

核心问题出在CRUDRepositoryJPA接口的静态成员变量初始化：

• 接口中的EntityManagerFactory emf是静态变量，会在接口被加载时自动执行Persistence.createEntityManagerFactory(Config.DB_NAME)初始化。
• Mockito在创建BookRepository的mock实例时，会加载它实现的所有接口，触发CRUDRepositoryJPA的静态初始化逻辑。
• 测试环境下通常没有配置对应的JPA持久化单元（Config.DB_NAME指向的配置不存在），导致Persistence.createEntityManagerFactory抛出异常，进而Mockito无法完成接口的字节码增强，最终无法mockBookRepository类。

另外，测试类中同时使用@Mock注解和mock()方法是冗余的，二者选其一即可，同时使用可能引发不必要的初始化问题。

1. 修复接口设计（推荐） #

接口不应该持有需要初始化的静态资源，建议将EntityManagerFactory改为通过依赖注入传入仓库实现类：

// 修改后的CRUDRepositoryJPA接口
public interface CRUDRepositoryJPA<T> extends CRUDRepository<T> {
    // 移除静态emf变量
}

// 修改后的BookRepository
public class BookRepository implements CRUDRepositoryJPA<Book> {
    private final EntityManagerFactory emf;

    // 通过构造方法注入依赖
    public BookRepository(EntityManagerFactory emf) {
        this.emf = emf;
    }

    // 其他实现代码
}

这种设计下，测试时MockBookRepository的方法即可，无需触发真实的JPA初始化逻辑。

2. 修正Mockito的使用方式 #

测试类中不要同时使用@Mock注解和mock()方法，任选一种方式初始化mock：

方式一：仅使用@Mock注解 #

public class ModelTest{
    @Mock
    private BookRepository bookRepository;
    private ClientModel model;

    @BeforeEach
    void setUp() {
        // 初始化所有@Mock注解的实例
        MockitoAnnotations.openMocks(this);
        
        model = new ClientModel();
        when(bookRepository.readAll()).thenReturn(TestConfig.defaultBooks());
        model.readRepositories();
    }

    // 测试方法
}

方式二：仅使用mock()方法 #

public class ModelTest{
    private BookRepository bookRepository;
    private ClientModel model;

    @BeforeEach
    void setUp() {
        bookRepository = mock(BookRepository.class);
        
        model = new ClientModel();
        when(bookRepository.readAll()).thenReturn(TestConfig.defaultBooks());
        model.readRepositories();
    }

    // 测试方法
}

3. 临时 workaround（不推荐） #

如果暂时无法修改接口设计，可以尝试使用PowerMock抑制静态初始化逻辑，但这会增加测试复杂度，不建议长期使用。

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