Spring JPA查询指定字段报错：ConverterNotFoundException问题求助

我之前也踩过这个坑，这其实是对JPA查询结果映射逻辑的理解偏差导致的，咱们一步步理清楚：

问题根源 #

你写的@Query("SELECT id, name FROM Season")并不会返回Season实体列表，而是返回包含id（Long类型）和name（String类型）的Object数组列表。Spring Data尝试把单个的Long值（数组第一个元素）转换成Season对象，自然找不到合适的转换器，就抛出了ConverterNotFoundException。

原因很简单：只有当你查询完整实体（比如SELECT s FROM Season s）时，JPA才会自动映射成Season实例；只查部分字段的话，JPA不知道怎么把零散的字段值组装成实体对象，所以默认返回字段值组成的数组。

解决方案 #

方案1：构造器查询（推荐，适合需要实体对象的场景） #

首先在Season实体中添加一个仅接收id和name的构造方法，注意要保留原有的无参构造方法（JPA要求实体必须有）：

public Season(Long id, String name) {
    this.id = id;
    this.name = name;
}

然后修改Repository中的@Query语句，明确调用这个构造器：

@Query("SELECT new com.vod.cloudservice.entity.Season(s.id, s.name) FROM Season s")
List<Season> findAllSeasons();

这里必须写实体的全类名，JPQL需要完整路径才能找到对应的构造方法。执行查询时，JPA会用你定义的构造方法创建Season实例，只填充id和name字段，其他未查询的字段（比如series、createTime）会是默认值（null或0）。

方案2：投影接口（更灵活，适合仅需部分字段的场景） #

如果不需要完整的Season实体，只是想获取id和name，可以定义一个投影接口：

public interface SeasonProjection {
    Long getId();
    String getName();
}

然后修改Repository的方法，让查询结果映射到这个接口：

// 方式1：自定义JPQL
@Query("SELECT s.id as id, s.name as name FROM Season s")
List<SeasonProjection> findAllSeasons();

// 方式2：Spring Data自动生成查询（更简洁）
List<SeasonProjection> findAllBy();

Spring Data会动态生成接口的实现类，自动把查询到的字段值注入进去，不需要额外写转换代码，非常灵活。

方案3：原生SQL查询（不推荐，仅适合复杂SQL场景） #

如果一定要用原生SQL，可以接收Object[]列表后手动转换：

@Query(value = "SELECT id, name FROM seasons", nativeQuery = true)
List<Object[]> findAllSeasons();

使用时遍历数组组装对象：

List<Object[]> results = seasonRepository.findAllSeasons();
List<Season> seasons = new ArrayList<>();
for (Object[] row : results) {
    Season season = new Season((Long) row[0], (String) row[1]);
    seasons.add(season);
}

这种方式需要手动处理类型转换，比较繁琐，除非是JPQL无法实现的复杂查询，否则不建议使用。

原理总结 #

• 当JPQL仅查询部分字段时，默认返回Object[]，每个数组元素对应一个查询字段；
• 构造器查询：通过new 全类名(字段1, 字段2)告知JPA用指定构造方法创建实体，实现字段到实体的映射；
• 投影接口：Spring Data利用动态代理技术生成接口实现类，自动将查询字段映射到接口的getter方法，无需修改实体类。

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