本文针对 Spring Boot 项目中使用 MapStruct 时可能遇到的自动注入失败问题，提供了详细的排查和解决步骤。通过检查 MapStruct 的配置、依赖以及使用方式，帮助开发者快速解决 `BetMapper` 无法注入到 `BetServiceMysql` 中的问题，确保项目正常运行。
在使用 Spring Boot 和 MapStruct 进行对象转换时，可能会遇到 Mapper 无法自动注入的问题，导致 NullPointerException 或启动失败。以下是一些常见的解决方案，涵盖了配置检查、依赖管理和代码修正等方面。
1. 确认 MapStruct 依赖和插件配置
首先，确保你的 pom.xml 文件中包含了 MapStruct 相关的依赖和插件。特别是 mapstruct-processor，它负责在编译时生成 Mapper 的实现类。
<dependencies><dependency><groupid>org.mapstruct</groupid><artifactid>mapstruct</artifactid><version>${mapstruct.version}</version></dependency></dependencies><build><plugins><plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><version>3.8.1</version><configuration><source>1.8</source><target>1.8</target><annotationprocessorpaths><path><groupid>org.mapstruct</groupid><artifactid>mapstruct-processor</artifactid><version>${mapstruct.version}</version></path></annotationprocessorpaths></configuration></plugin></plugins></build>
注意: 将 ${mapstruct.version} 替换为你使用的 MapStruct 版本。确保 maven-compiler-plugin 中配置了 annotationProcessorPaths，以便在编译时运行 MapStruct 的注解处理器。
2. 检查 Mapper 接口定义
确保 Mapper 接口使用 @Mapper 注解，并且指定了 componentModel = "spring"，这样 MapStruct 才会生成 Spring 管理的 Bean。
@Mapper(componentModel = "spring")
public interface BetMapper {
@Mapping(target = "id", source = "betRequest.betId")
Bet betResquetToEntity(BetRequest betRequest);
@Mapping(source = "id", target = "betId")
BetResponse entityToBetResponse(Bet bet);
}
注意: @Mapping 注解中的 source 和 target 属性需要正确指定源对象和目标对象的属性名。 仔细检查属性名是否匹配，避免出现映射错误。上面的例子中，@Mapping(target = "bet.id", source = "betId") 是不正确的，应该修改为 @Mapping(target = "id", source = "betRequest.betId")。
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
3. 检查 Service 类的依赖注入方式
确保 Service 类使用了正确的依赖注入方式。推荐使用构造器注入，并且不需要显式地使用 @Autowired 注解，因为 Spring Boot 会自动处理。
@Service
@AllArgsConstructor
public class BetServiceMysql implements BetService {
private final BetRepository betRepository;
private final BetMapper betMapper;
// ...
}
注意: 使用 @AllArgsConstructor 注解可以自动生成包含所有 final 字段的构造器。如果你的 Spring Boot 版本较低，可能需要手动添加 @Autowired 注解到构造器上。避免在字段上直接使用 @Autowired，推荐使用构造器注入。
4. 清理和重新构建项目
在修改了 pom.xml 或代码之后，建议清理和重新构建项目，以确保所有的更改都生效。
mvn clean install
5. 检查是否存在其他 Bean 定义冲突
如果项目中存在多个实现了相同接口的 Bean，可能会导致 Spring 无法确定要注入哪个 Bean。可以使用 @Primary 注解来指定首选的 Bean，或者使用 @Qualifier 注解来指定要注入的 Bean 的名称。但是对于 MapStruct 生成的 Mapper，一般不会出现这种情况，因为 MapStruct 会生成唯一的 Bean。
6. 总结
解决 Spring Boot 中 MapStruct 无法自动注入的问题，需要仔细检查项目的配置、依赖和代码。确保 MapStruct 的依赖和插件配置正确，Mapper 接口定义规范，Service 类的依赖注入方式正确，并清理和重新构建项目。通过以上步骤，通常可以解决 MapStruct 无法自动注入的问题，确保项目正常运行。
