如何在JUnit WebMvcTest中初始化RestController的私有字段（通过Setter）

针对测试DirectoryController的sync接口时future字段为null抛出异常的问题，以下是几种可行的解决方案：

方案1：直接调用公开Setter方法 #

这是最贴合代码设计的方式，因为类本身已经提供了setFuture方法。在@WebMvcTest测试类中，通过@Autowired获取Controller实例，手动传入Mock的ScheduledFuture对象即可：

@WebMvcTest(DirectoryController.class)
class DirectoryControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Autowired
    private DirectoryController directoryController;

    @MockBean
    private DirectoryService directoryService;

    @Mock
    private ScheduledFuture mockFuture;

    @BeforeEach
    void setUp() {
        // 初始化future字段
        directoryController.setFuture(mockFuture);
    }

    @Test
    void sync_shouldReturnSuccess_whenFutureIsInitialized() throws Exception {
        mockMvc.perform(get("/api/directory/sync"))
                .andExpect(status().isOk());
        // 添加业务逻辑相关断言
    }
}

方案2：反射设置私有字段（不推荐） #

如果类未提供公开Setter，可通过反射强制访问私有字段赋值，但这种方式会破坏封装性，仅在必要时使用：

@BeforeEach
void setUp() throws NoSuchFieldException, IllegalAccessException {
    Field futureField = DirectoryController.class.getDeclaredField("future");
    futureField.setAccessible(true);
    futureField.set(directoryController, mockFuture);
}

方案3：通过测试配置自动注入 #

创建测试专用配置类，注册Mock的ScheduledFuture Bean，Spring会自动识别公开的setFuture方法完成注入，无需手动调用Setter：

@WebMvcTest(DirectoryController.class)
@Import(TestConfig.class)
class DirectoryControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @MockBean
    private DirectoryService directoryService;

    @Test
    void sync_shouldReturnSuccess_whenFutureIsInjected() throws Exception {
        mockMvc.perform(get("/api/directory/sync"))
                .andExpect(status().isOk());
    }

    @Configuration
    static class TestConfig {
        @Bean
        public ScheduledFuture mockScheduledFuture() {
            return Mockito.mock(ScheduledFuture.class);
        }
    }
}

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