Spring Boot JUnit5中Mock Socket连接并验证方法调用顺序问题

针对你Mock Socket验证调用顺序时遇到的logger.debug("Trying to connect...")报"Wanted but not invoked"异常，下面是几个常见原因和对应的解决办法：

1. 静态Logger没被正确Mock #

如果你的Communicator类里的logger是静态初始化的（比如private static final Logger logger = LoggerFactory.getLogger(Communicator.class);），普通Mockito无法拦截静态方法调用，导致验证失败。

解决办法：

• 引入Mockito Inline依赖（Maven示例）：

<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-inline</artifactId>
    <version>4.11.0</version>
    <scope>test</scope>
</dependency>

• 在测试类中mock LoggerFactory和Logger：

@MockStatic(LoggerFactory.class)
private static LoggerFactory loggerFactory;
private Logger mockLogger;

@BeforeEach
void setup() {
    mockLogger = mock(Logger.class);
    when(LoggerFactory.getLogger(Communicator.class)).thenReturn(mockLogger);
}

2. 验证时的匹配条件不精准 #

如果实际代码里的logger.debug带参数（比如logger.debug("Trying to connect to {}:{}", host, port);），但你验证时只写了固定字符串"Trying to connect..."，就会匹配失败。

解决办法：

• 使用参数匹配器来兼容动态内容：

// 匹配包含指定字符串的日志，忽略参数
verify(mockLogger).debug(contains("Trying to connect..."), anyString(), anyInt());
// 如果没有参数，直接精确匹配
verify(mockLogger).debug("Trying to connect...");

3. 调用顺序验证的链路断裂 #

如果整个方法调用链中某个前置方法没执行（比如TCP连接启动逻辑没走到打印日志的分支），自然不会触发logger.debug。建议先单独验证日志调用，再验证整体顺序。

解决办法：

// 先单独确认日志是否被调用
verify(mockLogger).debug("Trying to connect...");
// 再验证方法调用顺序
InOrder inOrder = inOrder(communicator, listenerMock, ...);
inOrder.verify(communicator).startTcpConnection();
inOrder.verify(communicator).startListener();
// 按你的期望顺序依次验证后续方法

4. Socket Mock没触发目标代码分支 #

如果startTcpConnection里只有在Socket连接成功/失败的特定分支才会打印这条日志，而你Mock的Socket没有模拟对应场景，那该行代码不会执行。

解决办法：

• 用Mockito的mockConstruction模拟Socket的创建过程，确保触发打印日志的代码分支：

try (MockedConstruction<Socket> mockedSocket = mockConstruction(Socket.class, (mock, context) -> {
    // 这里可以模拟Socket连接的行为，比如不抛出IOException
})) {
    // 执行测试方法
    communicator.connect();
    // 验证日志调用
    verify(mockLogger).debug("Trying to connect...");
}

5. 测试环境日志级别过高 #

如果测试环境的日志级别设置为INFO或更高，debug级别的日志会被过滤，不会实际调用logger的debug方法。

解决办法：

• 在测试类里强制设置目标类的日志级别为DEBUG：

@BeforeAll
static void setupLogging() {
    LoggerContext context = (LoggerContext) LoggerFactory.getILoggerFactory();
    Logger logger = context.getLogger(Communicator.class);
    logger.setLevel(Level.DEBUG);
}

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