在@WebMvcTest集成测试中如何正确注入MapStruct生成的Mapper

看起来你在测试Spring Boot控制器时遇到了依赖注入的问题，核心原因是@WebMvcTest的设计就是只加载控制器相关的Bean，不会自动帮你加载Service、MapStruct Mapper这类依赖，下面我给你一步步解决这个问题：

1. 先搞清楚问题根源 #

• 你直接@Import(UserMapper.class)会报错，因为它是MapStruct定义的接口，Spring没办法直接实例化接口——MapStruct会在编译时自动生成它的实现类（比如UserMapperImpl），这个才是真正可以被Spring管理的Bean。
• 换成@Import(UserMapperImpl.class)后又缺UserService，是因为@WebMvcTest不会自动扫描并加载Service层的Bean，它只关注控制器本身。

2. 正确的测试配置方案 #

我们的目标是聚焦测试控制器的逻辑，所以不需要加载真实的UserService（否则会牵扯到它的依赖链，比如DAO层），而是用Mock来模拟UserService；而UserMapper是无状态的DTO转换工具，可以直接用它的真实实现：

修改后的测试代码如下：

@WebMvcTest(UserControllerImpl.class)
@Import(UserMapperImpl.class) // 导入MapStruct编译生成的Mapper实现类
@TestInstance(TestInstance.Lifecycle.PER_CLASS)
public class UserControllerTests {
    @Autowired
    private MockMvc mockMvc;

    @MockBean // 用Spring的MockBean模拟UserService
    private UserService userService;

    @Autowired
    private UserMapper userMapper; // 可选：如果需要验证Mapper转换逻辑，可以注入

    @Test
    public void shouldGetAuthenticatedUser() throws Exception {
        // 1. 准备模拟数据
        String testUsername = "test_user";
        UserEntity mockUserEntity = new UserEntity();
        mockUserEntity.setLogin(testUsername);
        // 2. 设定MockService的行为：当调用findByLoginOrError时返回模拟的UserEntity
        when(userService.findByLoginOrError(testUsername)).thenReturn(mockUserEntity);

        // 3. 执行请求并验证结果
        this.mockMvc.perform(get("/api/users/me").with(oidcLogin()))
                .andExpect(status().isOk())
                // 可以进一步验证返回的DTO字段是否正确
                .andExpect(jsonPath("$.login").value(testUsername));
    }
}

3. 关键细节说明 #

• 为什么用@MockBean？：它会让Spring容器创建一个Mock版本的UserService，这样你可以完全控制它的行为，不用关心真实Service的实现和依赖，让测试只关注控制器的逻辑（比如是否正确处理认证、是否调用Mapper转换、是否返回正确响应）。
• 关于UserMapperImpl：确保你的项目已经完成编译，MapStruct会在编译阶段自动生成这个类。如果找不到这个类，检查你的构建配置（Maven/Gradle）是否正确引入了MapStruct插件和依赖。
• 移除多余注解：@AutoConfigureWebMvc已经被@WebMvcTest包含了，不需要重复添加。

这样配置后，Spring就能正确注入UserMapperImpl和Mock的UserService，你的控制器测试就能正常运行了。

备注：内容来源于stack exchange，提问作者udduu