使用ReflectionTestUtils修改静态非final字段抛出IllegalArgumentException问题

问题原因 #

异常的核心是类型不兼容：

• 目标类App中的logger字段类型为org.slf4j.Logger（SLF4J日志门面接口）
• 测试代码中mock的是org.apache.logging.log4j.core.Logger（Log4j2的具体实现类）

这两个类分属不同的日志API体系，不存在继承或实现关系，反射设置字段时JVM会严格校验类型匹配，因此抛出IllegalArgumentException。

解决方案 #

1. 修正Mock的Logger类型 #

将测试代码中mock的Logger改为与目标字段一致的org.slf4j.Logger类型，修改后的测试代码如下：

package sample;

import org.junit.jupiter.api.Test;
import org.slf4j.Logger; // 替换为SLF4J的Logger导入
import org.springframework.test.util.ReflectionTestUtils;

import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.verify;
import static org.mockito.ArgumentMatchers.anyString;

public class AppTest {

    @Test
    public void doSomething() throws Exception {
        App app = new App();

        // Mock SLF4J的Logger接口，与目标字段类型匹配
        Logger mockedLogger = mock(Logger.class);

        ReflectionTestUtils.setField(App.class, "logger", mockedLogger);
        
        // 执行目标方法并验证Logger调用
        app.doSomething();
        verify(mockedLogger).error(anyString());
    }
}

补充说明 #

• SLF4J作为日志门面，设计目的就是解耦业务代码与具体日志实现，因此业务类中使用org.slf4j.Logger是标准做法，测试时也应mock对应的门面接口而非底层实现类。
• 如果需要验证日志输出的内容或调用次数，可添加Mockito的verify逻辑（如上例所示），确保测试逻辑完整。

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