SpringBoot中MapStruct转换Entity到DTO报错：无可用转换器

核心问题 #

你当前的错误根源在于Repository的查询返回结果类型和你期望的转换路径不匹配：

• 你的@Query("SELECT b.name, b.sex FROM Bird b WHERE b.id = 1")查询返回的是一组独立字段（name和sex），JPA会将其包装为TupleBackedMap类型的对象。
• 但你配置的MapStruct转换器birdToBirdTestDTO(Bird bird)是接收Bird实体类来转换为DTO，Spring Data无法自动将TupleBackedMap先转成Bird再调用MapStruct，因此直接抛出了转换器找不到的错误。

解决方案 #

方案一：查询完整实体，通过MapStruct转换（推荐） #

这是最符合你使用MapStruct初衷的方式：

1. 修改Repository的查询语句，返回完整的Bird实体：

@Query("SELECT b FROM Bird b WHERE b.id = 1")
Bird findmyBird();

2. 在Service层注入BirdMapper，调用转换方法得到DTO：

@Service
public class BirdService {
    private final BirdRepository birdRepository;
    private final BirdMapper birdMapper;

    public BirdService(BirdRepository birdRepository, BirdMapper birdMapper) {
        this.birdRepository = birdRepository;
        this.birdMapper = birdMapper;
    }

    public BirdTestDTO getBirdTestDTO() {
        Bird bird = birdRepository.findmyBird();
        return birdMapper.birdToBirdTestDTO(bird);
    }
}

方案二：直接查询映射到DTO（无需MapStruct） #

如果不想查询完整实体，可让JPA直接通过构造函数将查询结果映射到DTO：
修改Repository的@Query语句，使用DTO的带参构造函数：

@Query("SELECT new com.nz.bird.dto.BirdTestDTO(b.name, b.sex) FROM Bird b WHERE b.id = 1")
BirdTestDTO findmyBird();

这种方式下，JPA会直接调用DTO的带参构造函数生成对象，不需要额外的转换器，适合只需要部分字段的场景。

补充说明 #

• 你的MapStruct配置本身没有问题，componentModel = "spring"会让Spring管理Mapper实例，错误只是因为查询结果没有走到MapStruct的转换流程里。
• 如果坚持要使用MapStruct处理字段集合到DTO的转换，需要额外编写Map或Tuple到DTO的转换方法，但这种方式不如上述两种方案简洁。

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