Hibernate单独查询JSONB映射字段报错，如何复用已有转换器？

我有一个映射JSONB列的Hibernate实体，操作整个对象时可通过Repository轻松完成存储与读取：

@Entity
public class Parent {
...
  @Column(name = "children", nullable = false, columnDefinition = "JSONB")
  @Type(JsonType.class)
  List<Child> children;
...
}

我希望添加一个Repository方法单独加载该列，尝试了如下代码：

@Query("""
      SELECT p.children
      FROM Parent p
      WHERE p.id = :parentId
      """)
  List<Child> getChildren(@Param("parentId") long parentId);

但出现错误：

org.springframework.core.convert.ConverterNotFoundException: No converter found capable of converting from type [org.springframework.data.jpa.repository.query.AbstractJpaQuery$TupleConverter$TupleBackedMap] to type [com.example.Child]
    at org.springframework.core.convert.support.GenericConversionService.handleConverterNotFound(GenericConversionService.java:322)
    at org.springframework.core.convert.support.GenericConversionService.convert(GenericConversionService.java:195)
    at org.springframework.core.convert.support.GenericConversionService.convert(GenericConversionService.java:175)
...

加载整个Parent类时List可正常获取，说明项目中已存在对应转换器，请问如何复用它实现单独加载该列？

解决方案 #

方式1：使用投影接口匹配实体属性映射 #

定义一个仅包含目标属性的投影接口，让Spring Data JPA复用实体上的@Type转换器逻辑：

// 定义投影接口
interface ParentChildrenProjection {
    List<Child> getChildren();
}

// 在Repository中添加查询方法
@Query("""
    SELECT p.children AS children
    FROM Parent p
    WHERE p.id = :parentId
    """)
ParentChildrenProjection getChildrenProjection(@Param("parentId") long parentId);

使用时直接从投影对象中提取List：

List<Child> children = parentRepository.getChildrenProjection(parentId).getChildren();

这种方式的核心是投影的属性名称与实体中children属性完全匹配，Spring Data JPA会自动应用实体上配置的@Type(JsonType.class)转换器，避免手动处理JSON转换。

方式2：原生查询返回JSON字符串后手动转换 #

通过原生查询直接获取JSONB列的原始字符串，再用项目中已有的JSON转换器（比如Jackson ObjectMapper）解析为List<Child>：

// Repository中添加原生查询方法
@Query(value = """
    SELECT p.children
    FROM parent p
    WHERE p.id = :parentId
    """, nativeQuery = true)
String getChildrenJson(@Param("parentId") long parentId);

在Service层完成转换（复用项目中已有的ObjectMapper实例）：

@Autowired
private ObjectMapper objectMapper;

public List<Child> getChildren(long parentId) {
    String json = parentRepository.getChildrenJson(parentId);
    return objectMapper.readValue(json, new TypeReference<List<Child>>() {});
}

方式3：自定义Repository实现（最简复用方式） #

如果允许加载整个Parent实体（Hibernate可能会做懒加载优化，仅查询必要列），可以自定义Repository实现类，直接通过EntityManager获取实体后提取children：

// 扩展Repository接口
public interface ParentRepository extends JpaRepository<Parent, Long>, ParentRepositoryCustom {
}

// 定义自定义方法接口
public interface ParentRepositoryCustom {
    List<Child> getChildren(long parentId);
}

// 实现自定义逻辑
public class ParentRepositoryImpl implements ParentRepositoryCustom {
    @PersistenceContext
    private EntityManager em;

    @Override
    public List<Child> getChildren(long parentId) {
        Parent parent = em.find(Parent.class, parentId);
        return parent.getChildren();
    }
}

这种方式完全复用实体上已有的类型转换逻辑，代码实现最简单，适合对性能要求不是极致苛刻的场景。

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