Mockito测试DriverManager抛SQLException遇UnfinishedStubbing异常问题

我正在测试以下Query类的构造函数：

public Query(String sql, Object... parameters) throws SQLException {
    try {
        this.conn = DriverManager.getConnection(Credential.URL, Credential.USER, Credential.PASSWORD);
        this.preparedQuery = conn.prepareStatement(sql);

        for (int i = 0; i < parameters.length; i++) {
            this.preparedQuery.setObject(i + 1, parameters[i]);
        }

        this.results = preparedQuery.executeQuery();
        log.info("Connection established and query executed successfully.");
    } catch (SQLTimeoutException e) {
        log.error("Connection timeout exceeded: {}", e.getMessage());
        throw e;
    } catch (SQLException e) {
        log.error("Error executing query: {}", e.getMessage());
        throw e;
    }
}

我编写了如下测试代码（使用Mockito 4.0.0）：

@Test
public void testConstructorThrowsSQLException() {
    try (MockedStatic mockedDriverManager = mockStatic(DriverManager.class)) {

        mockedDriverManager.when(() -> DriverManager.getConnection(anyString(), anyString(), anyString()))
            .thenThrow(new SQLException("Database connection error"));
    }
}

问题：当使用.thenThrow(new SQLException("Database connection error"))时，Mockito会抛出UnfinishedStubbing异常；但改为.thenThrow(SQLException.class)时却能正常运行，这是什么原因？

原因分析 #

这是因为在静态方法存根的过程中直接创建异常实例，会触发Mockito的存根校验机制，具体细节如下：

• Mockito处理静态方法存根时，要求整个存根流程（从when()到thenXXX()）必须在一个"无干扰"的上下文里完成——不能在存根逻辑内部执行任何可能破坏存根状态的操作。当你直接new SQLException("...")时，这个实例创建动作会被Mockito的校验逻辑判定为存根流程未完成，从而抛出UnfinishedStubbing异常。
• 而使用.thenThrow(SQLException.class)时，Mockito会在目标方法被实际调用时，才动态创建异常实例。这个过程发生在存根逻辑完全完成之后，完全符合Mockito的存根规则，因此不会触发异常。

另外补充：你当前的测试代码还缺少关键步骤——没有实际调用Query类的构造函数，所以即使存根正确，也无法验证异常是否被抛出。完整的测试需要在存根后添加断言逻辑，比如：

assertThrows(SQLException.class, () -> new Query("test sql"));

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