Spring Boot 2.7手动事务测试遇Mockito匹配器异常求助

云原生阿岚

2026-6-21

问题解决：Mockito参数匹配器误用报错

错误原因

报错Invalid use of argument matchers! 3 matchers expected, 1 recorded的核心问题出在TransactionTemplate的mock逻辑里：你在调用doInTransaction(any(TransactionStatus.class))时，直接使用了Mockito的any()匹配器，但这个匹配器只能在Mockito的when()/verify()等Stub/验证方法中使用，不能作为普通方法的参数传递。此时Mockito会误以为你在Stub某个需要3个匹配器的方法，但实际只传了1个，因此抛出异常。

修复步骤

修改TransactionTemplate的mock代码，将any(TransactionStatus.class)替换为一个mock的TransactionStatus实例：

// 先创建一个mock的TransactionStatus对象
TransactionStatus mockTransactionStatus = Mockito.mock(TransactionStatus.class);

// 重新Stub TransactionTemplate的execute方法
when(transactionTemplate.execute(any(TransactionCallback.class)))
        .then(invocation -> ((TransactionCallback<Doc>) invocation.getArgument(0))
                .doInTransaction(mockTransactionStatus)); // 传入mock实例而非匹配器

额外注意

原业务代码中findDoc方法存在语法错误：

// 原错误代码（多了一个右括号）
return docRepository.findByDocType(document.getType(), document.getId()), document.getReport()).get(0);
// 修正后
return docRepository.findByDocType(document.getType(), document.getId(), document.getReport()).get(0);