Mapstruct注入报错：找不到UserMapper类型Bean的求助

核心问题分析 #

启动报错的本质是Mapstruct没有生成对应的实现类，所以Spring容器找不到UserMapper类型的Bean——接口本身不是Spring Bean，只有Mapstruct生成的带@Component注解的实现类才会被Spring扫描并注册，和@ComponentScan配置无关。

问题原因 #

1. Maven编译器插件版本未明确指定：pom中使用了${maven-compiler-plugin.version}变量，但未在<properties>中定义该值，导致插件版本可能不兼容，Mapstruct注解处理器无法正常触发。
2. 启动类注解冗余冲突：@SpringBootApplication已经包含@EnableAutoConfiguration、@ComponentScan和@Configuration，重复添加这些注解可能干扰Spring的组件扫描逻辑。

解决办法 #

1. 修复Maven编译器插件配置 #

在pom.xml的<properties>中添加编译器插件版本（对应Spring Boot 2.7.7的兼容版本），确保注解处理器正常执行：

<properties>
    <java.version>11</java.version>
    <org.mapstruct.version>1.5.2.Final</org.mapstruct.version>
    <!-- 添加Spring Boot 2.7.7兼容的编译器插件版本 -->
    <maven-compiler-plugin.version>3.10.1</maven-compiler-plugin.version>
</properties>

2. 简化Spring Boot启动类注解 #

删除重复的注解，保留@SpringBootApplication即可，它会自动处理组件扫描、自动配置等核心逻辑：

package com.mycomp.myappapi;

@SpringBootApplication
@EntityScan(basePackages = {"com.mycomp.myappapi.model"})
@EnableJpaRepositories(basePackages = {"com.mycomp.myappapi.repository"})
@EnableTransactionManagement
@EnableWebMvc
@RestController
public class myappapiApplication {

    public static void main(String[] args) {
        SpringApplication.run(myappapiApplication.class, args);
    }

}

注：@RestController加在启动类上功能正常，但从代码规范角度，建议将控制器逻辑拆分到单独的类中。

3. 重新编译生成实现类 #

执行Maven命令清理并重新编译项目：

mvn clean compile

编译完成后检查target/classes/com/mycomp/myappapi/mapper/目录下是否生成了UserMapperImpl.class文件，确认Mapstruct实现类已成功生成。

4. 额外提示（若使用Lombok） #

如果项目同时使用Lombok，需在注解处理器路径中添加Lombok依赖，避免两者冲突：

<annotationProcessorPaths>
    <path>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>${org.mapstruct.version}</version>
    </path>
    <path>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>${lombok.version}</version>
    </path>
    <!-- 若需要Lombok与Mapstruct绑定，再添加lombok-mapstruct依赖 -->
</annotationProcessorPaths>

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