Spring Boot中MapStruct无法注入容器：NoSuchBeanDefinitionException问题

核心问题是MapStruct的实现类未被生成，导致Spring容器中找不到CustomerMapper类型的Bean。你的配置仅引入了MapStruct核心依赖，但缺少编译时生成实现类的注解处理器，同时使用不稳定的Beta版本也可能引发兼容性问题。

一、修正Maven依赖配置 #

替换现有MapStruct依赖，添加注解处理器，并使用稳定版本（推荐1.5.5.Final，与Spring Boot兼容性更好）：

<dependencies>
    <!-- MapStruct核心依赖 -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>1.5.5.Final</version>
    </dependency>
    <!-- MapStruct注解处理器，编译时生成实现类 -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>1.5.5.Final</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

二、配置Maven编译插件（关键步骤） #

确保maven-compiler-plugin明确指定MapStruct的注解处理器，避免编译时跳过生成逻辑：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version> <!-- 适配你的Java版本，Java 17建议用3.11.0+ -->
            <configuration>
                <source>17</source> <!-- 替换为你的项目Java版本 -->
                <target>17</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>1.5.5.Final</version>
                    </path>
                    <!-- 若项目使用Lombok，需添加以下处理器路径 -->
                    <!--
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>1.18.30</version>
                    </path>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok-mapstruct-binding</artifactId>
                        <version>0.2.0</version>
                    </path>
                    -->
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

三、验证与清理 #

1. 执行mvn clean compile，查看控制台是否有MapStruct生成代码的日志，比如Generating implementation for dev.earl.order_owl.service.mapper.CustomerMapper。
2. 检查target/generated-sources/annotations目录下是否生成了CustomerMapperImpl类，该类会带有@Component注解，被Spring扫描为Bean。
3. 确认Spring Boot主类（OrderOwlApplication）的包扫描范围覆盖dev.earl.order_owl.service.mapper包（默认主类所在包及子包都会被扫描，你的结构应符合要求）。

四、额外注意事项 #

• 避免使用Beta版本的MapStruct，1.6.x Beta版本可能存在未修复的兼容性问题，优先选择稳定版。
• 若项目搭配Lombok使用，必须添加lombok-mapstruct-binding依赖并配置到注解处理器路径，否则可能出现字段映射失效或生成类异常。

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