Spring Boot中MapStruct无法被定义为Bean的问题求助

问题背景 #

Spring Boot项目原有REST POST接口通过ObjectMapper转换CustomerDTO到Customer实体，功能正常。引入MapStruct后启动报错，提示找不到CustomerMapper类型的Bean。

错误信息 #

Parameter 1 of constructor in com.project.dbproject.service.CustomerService required a bean of type 'com.project.dbproject.CustomerMapper' that could not be found.

The injection point has the following annotations:

• @org.springframework.beans.factory.annotation.Autowired(required=true)

Action:

Consider defining a bean of type 'com.project.dbproject.CustomerMapper' in your configuration.

核心原因 #

MapStruct依赖注解处理器在编译时生成接口实现类，当前pom.xml缺少注解处理器依赖及编译插件配置，导致Spring无法识别自动生成的Mapper实现Bean。

解决方案 #

1. 补充MapStruct注解处理器依赖 #

在pom.xml的<dependencies>节点中添加：

<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>1.5.0.Final</version>
    <scope>provided</scope>
</dependency>

2. 配置Maven编译插件，适配Lombok与MapStruct协同工作 #

修改pom.xml的<build>节点，添加编译插件配置（注意MapStruct处理器需放在Lombok之后）：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <excludes>
                    <exclude>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                    </exclude>
                </excludes>
            </configuration>
        </plugin>
        <!-- 新增编译插件配置 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <source>21</source>
                <target>21</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>1.18.30</version> <!-- 替换为你项目使用的Lombok版本 -->
                    </path>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>1.5.0.Final</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

3. 优化CustomerService的依赖注入方式 #

同时使用@RequiredArgsConstructor和@Autowired会导致冲突，统一使用构造注入：

@Service
@RequiredArgsConstructor
@Slf4j
public class CustomerService {

    private final CustomerRepository customerRepository;
    private final CustomerMapper customerMapper;
    private final ObjectMapper objectMapper;

    // 原有业务方法保持不变
}

移除所有@Autowired注解，@RequiredArgsConstructor会自动生成包含final字段的构造方法，Spring将自动完成依赖注入。

4. 重新编译并启动项目 #

执行mvn clean install命令清理并编译项目，确保MapStruct生成实现类；之后重启Spring Boot应用。

验证 #

检查项目的target/classes目录下，是否存在CustomerMapperImpl类（与CustomerMapper同包路径），若存在则说明编译成功，Spring可正常扫描并注入该Bean。

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