SpringBoot 2.5.14项目启动报错：LogMapper类型Bean不存在

核心报错是NoSuchBeanDefinitionException: No qualifying bean of type 'demo.mapper.LogMapper' available，说明MapStruct未为LogMapper生成Spring管理的实现类，导致Spring容器无法找到该Bean。以下是针对性解决步骤：

1. 修正Maven插件版本变量不一致问题 #

你的依赖中用${mapstruct.version}定义MapStruct版本，但maven-compiler-plugin里的mapstruct-processor引用的是${org.mapstruct.version}，若pom.xml未定义该变量，会导致处理器版本不匹配甚至无法加载。修改插件配置：

<path>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>${mapstruct.version}</version> <!-- 替换为和依赖一致的变量 -->
</path>

2. 添加Lombok-MapStruct绑定依赖 #

Lombok与MapStruct的注解处理器需要协调工作，添加绑定依赖可避免注解处理冲突：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok-mapstruct-binding</artifactId>
    <version>0.2.0</version>
    <scope>provided</scope>
</dependency>

同时将该依赖加入annotationProcessorPaths，注意顺序：Lombok → Lombok-MapStruct绑定 → MapStruct处理器

<path>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok-mapstruct-binding</artifactId>
    <version>0.2.0</version>
</path>

3. 验证MapStruct实现类是否生成 #

执行mvn clean compile后，检查target/generated-sources/annotations目录下是否存在demo/mapper/LogMapperImpl.class：

• 若存在：说明生成正常，检查Spring扫描范围是否包含该包（@SpringBootApplication默认扫描启动类所在包及子包，确保LogMapper在对应范围内）。
• 若不存在：说明MapStruct处理器未执行，检查Maven编译插件的source/target版本是否与JDK匹配，或是否有其他编译插件干扰。

4. 检查BaseMapper定义 #

确保BaseMapper中的方法符合MapStruct规范（比如convertToEntity等方法的签名正确），MapStruct需要识别父接口的方法才能生成有效实现。

5. 清理并重新构建 #

执行命令彻底清理旧编译文件并重新构建：

mvn clean install

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