在 java 单元测试中,mockito 本身无法直接 mock 普通类的构造方法,必须借助 mockito-inline 或 mockito-subclass 扩展包来实现对非接口类型的构造方法 mock。具体做法是引入对应的依赖,并使用 mockconstruction() 方法来拦截并替换指定构造函数的行为,从而在测试中控制被创建对象的返回结果。

如何配置环境以支持构造方法 Mock
要使用 Mockito 的构造方法 Mock 功能,首先需要确保项目引入了支持该功能的依赖。从 Mockito 3.4.0 版本开始,核心库不再包含对 final 类或非接口类的构造方法 Mock 能力,因此需要额外引入 mockito-inline 依赖(对于较新版本如 5.x+,通常已整合进 mockito-core 或通过 mockito-junit-jupiter 提供)。一旦依赖就绪,就可以通过 Mocker 接口来管理 Mock 的作用域。

import org.mockito.MockedConstruction;nimport org.mockito.Mockito;
public class UserServiceTest {
@Test
public void testCreateUser() {
// 定义 Mock 的行为:当 new EmailService() 被调用时,返回一个 Mock 对象
EmailService mockEmailService = Mockito.mock(EmailService.class);
try (MockedConstruction<emailservice> mocked = Mockito.mockConstruction(EmailService.class,
(mock, context) -> {
// 可选:设置具体的行为
Mockito.when(mock.send("test")).thenReturn(true);
})) {
// 执行被测代码
UserService service = new UserService();
boolean result = service.register("user", "email");
// 验证
Mockito.verify(mock).send("email");
Assert.assertTrue(result);
}
}
}</emailservice>
上述代码展示了标准的用法:MockedConstruction 是一个 AutoCloseable 资源,必须在 try-with-resources 块中使用,以确保作用域结束后自动恢复原始构造函数行为。在 lambda 表达式中,可以进一步配置 Mock 对象的具体行为,例如模拟 send 方法的返回值。
如何验证构造方法被正确调用及参数匹配
在实际测试中,仅仅 Mock 构造方法还不够,通常需要验证被 Mock 的对象是否被正确实例化,以及传入构造函数的参数是否符合预期。MockedConstruction.Context 提供了获取被构造对象实例的方法,允许我们在测试断言中检查这些细节。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import org.mockito.MockedConstruction;
import org.mockito.Mockito;
import org.mockito.ArgumentCaptor;
@Test
public void testConstructorArgs() {
ArgumentCaptor<string> emailCaptor = ArgumentCaptor.forClass(String.class);
try (MockedConstruction<emailservice> mocked = Mockito.mockConstruction(EmailService.class)) {
// 触发构造
new UserService().register("user", "test@example.com");
// 获取所有被构造的实例
java.util.List<emailservice> instances = mocked.constructed();
Assert.assertEquals(1, instances.size());
// 验证上下文中的参数
Mockito.verify(instances.get(0)).send(emailCaptor.capture());
Assert.assertEquals("test@example.com", emailCaptor.getValue());
}
}</emailservice></emailservice></string>
在这个例子中,我们使用了 ArgumentCaptor 来捕获传递给 Mock 对象方法的参数,同时通过 mocked.constructed() 获取实际创建的实例列表。这确保了构造方法不仅被调用,而且是在正确的上下文中被调用的。注意,mocked.constructed() 返回的是按调用顺序排列的实例列表,可以通过索引访问特定的实例进行更细致的验证。
如何处理多个相同类型构造方法的 Mock 冲突
当系统中存在多个地方调用同一个类的构造函数时,直接使用 mockConstruction(Class) 会导致所有该类的实例都被 Mock,这可能不是预期的行为。为了解决这个问题,可以使用 mockConstruction(Class, Predicate) 来过滤哪些构造调用需要被 Mock。Predicate 接收 MockedConstruction.Context,可以根据构造参数的值来决定是否应用 Mock。
try (MockedConstruction<emailservice> mocked = Mockito.mockConstruction(
EmailService.class,
(context) -> {
// 只有当第一个参数是 "admin" 时才 Mock
return context.arguments().get(0).equals("admin");
},
(mock, context) -> {
Mockito.when(mock.send(Mockito.anyString())).thenReturn(true);
})) {
// 这里只会 Mock 参数为 "admin" 的构造调用
new UserService().registerAdmin("admin_user", "admin@example.com");
// 其他构造调用将使用真实实现
new UserService().registerNormal("normal_user", "normal@example.com");
}</emailservice>
通过这种方式,可以精确控制 Mock 的范围,避免副作用。Predicate 逻辑应当简单且确定,基于构造参数的内容做出判断。如果条件复杂,建议提取为独立方法以保持代码可读性。此外,如果不需要自定义 Mock 行为,仅想替换实例,可以省略第二个 lambda 参数,Mockito 会自动生成一个默认 Mock 对象。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










