重启电脑后Spring Boot启动报错：找不到MapStruct生成的PersonMapper Bean

问题现象 #

使用Spring Boot结合MapStruct开发应用时，每次重启电脑后启动应用都会抛出如下错误：

Description:

Field personMapper in com.paulo.enterprise.credito.services.PersonServices required a bean of type 'com.paulo.enterprise.credito.mapper.PersonMapper' 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.paulo.enterprise.credito.mapper.PersonMapper' in your configuration.

目前临时解决办法是执行mvn clean compile，之后应用可正常启停，但重启电脑后问题会重复出现，必须重新执行该命令。开发环境为Eclipse IDE，数据库使用Docker部署的PostgreSQL。

核心原因与解决方案 #

问题本质是重启电脑后，Eclipse或Maven未自动触发MapStruct的注解处理器生成实现类，导致Spring容器无法找到对应的Bean。以下是针对性的解决步骤：

1. 配置Eclipse注解处理器自动生效 #

重启电脑后Eclipse可能重置编译配置，需确保注解处理器始终开启：

• 右键项目 → Properties
• 进入Java Compiler > Annotation Processing，勾选Enable annotation processing
• 切换到Factory Path标签，点击Add External JARs，添加本地Maven仓库中的mapstruct-processor-1.5.5.Final.jar（路径一般为~/.m2/repository/org/mapstruct/mapstruct-processor/1.5.5.Final/）
• 点击Apply and Close，执行Project > Clean重新构建项目

2. 完善Maven编译插件配置 #

在pom.xml的maven-compiler-plugin中补充Java版本配置，确保编译环境与项目Java版本一致，避免版本不兼容导致的注解处理器失效：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <!-- 补充与项目一致的Java版本 -->
        <source>${java.version}</source>
        <target>${java.version}</target>
        <annotationProcessorPaths>
            <path>
                <groupId>org.mapstruct</groupId>
                <artifactId>mapstruct-processor</artifactId>
                <version>${org.mapstruct.version}</version>
            </path>
        </annotationProcessorPaths>
    </configuration>
</plugin>

3. 让Spring主动扫描Mapper接口 #

在Spring Boot启动类上添加@MapperScan注解，指定Mapper所在包路径，确保Spring容器能自动识别MapStruct生成的实现类：

@SpringBootApplication
@MapperScan("com.paulo.enterprise.credito.mapper") // 扫描Mapper包
public class MyappApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyappApplication.class, args);
    }
}

4. 清理Eclipse缓存避免编译异常 #

若上述配置后仍有问题，可清理Eclipse缓存并重新导入项目：

• 删除项目根目录下的.classpath、.project文件（提前备份）
• 在Eclipse中执行File > Import > Existing Maven Projects，重新导入项目
• 执行mvn clean install后再启动应用

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