如何在DTO中定义Hibernate自定义类型？解决JDBC类型2003映射问题

你遇到的"No Dialect mapping for JDBC type: 2003"错误，本质是原生JPA查询返回text[]类型字段时，Hibernate无法找到对应的类型转换器——虽然实体类上定义了@TypeDef，但原生查询不会自动关联实体类的类型映射规则。

方法1：先查实体类再转换为DTO #

这是最直接的实现方式，先通过JPA查询获取Field实体，再手动转换为FieldDetails：

修改Repository方法 #

@Query("SELECT f FROM Field f WHERE f.id = :id")
Field getFieldById(Long id);

服务层转换示例 #

public FieldDetails getFieldDetails(Long id) {
    Field field = fieldRepository.getFieldById(id);
    return new FieldDetails() {
        @Override
        public String getTitle() { return field.getTitle(); }
        @Override
        public Point gpsCoordinates() { return field.getGpsCoordinates(); }
        @Override
        public BigDecimal getAcreage() { return field.getAcreage(); }
        @Override
        public String getMemo1() { return field.getMemo1(); }
        @Override
        public String[] getPhotoPath() { return field.getPhotoPath(); }
    };
}

优点：无需修改类型映射逻辑，直接复用实体类已有的@TypeDef自动处理数组转换。

方法2：在原生查询中指定类型映射 #

通过EntityManager手动构建查询，用addScalar明确指定photo_path的类型为自定义的string-array：

自定义Repository实现 #

@Repository
public class FieldRepositoryImpl implements FieldCustomRepository {

    @PersistenceContext
    private EntityManager entityManager;

    @Override
    public FieldDetails getFieldDetails(Long id) {
        String sql = "SELECT f.title, f.gps_coordinates, f.acreage, f.memo1, f.photo_path FROM public.field f WHERE f.id = :id";
        
        return entityManager.createNativeQuery(sql)
                .setParameter("id", id)
                .addScalar("title", StringType.INSTANCE)
                .addScalar("gps_coordinates", GeometryType.INSTANCE)
                .addScalar("acreage", BigDecimalType.INSTANCE)
                .addScalar("memo1", StringType.INSTANCE)
                .addScalar("photo_path", new StringArrayType())
                .unwrap(org.hibernate.query.Query.class)
                .setResultTransformer(Transformers.aliasToBean(FieldDetails.class))
                .uniqueResult();
    }
}

注意：确保FieldDetails接口的方法名与查询结果的字段/别名完全匹配。

方法3：扩展Hibernate方言，全局注册数组类型映射 #

如果项目中大量用到text[]类型的原生查询，可以自定义方言全局注册映射规则：

自定义方言类（以PostgreSQL为例） #

public class CustomPostgreSQLDialect extends PostgreSQLDialect {
    public CustomPostgreSQLDialect() {
        super();
        // 注册JDBC类型2003（数组）到自定义的string-array类型
        registerHibernateType(Types.ARRAY, "string-array");
    }
}

配置方言到application.properties #

spring.jpa.properties.hibernate.dialect=com.yourpackage.CustomPostgreSQLDialect

此后原生查询中遇到text[]类型时，Hibernate会自动用StringArrayType转换，无需每次查询单独配置。

方法4：改用JPQL查询而非原生查询 #

JPQL会自动识别实体类上的@TypeDef规则，直接修改查询语句即可返回FieldDetails接口：

修改Repository方法 #

@Query("SELECT f.title as title, f.gpsCoordinates as gpsCoordinates, f.acreage as acreage, f.memo1 as memo1, f.photoPath as photoPath FROM Field f WHERE f.id = :id")
FieldDetails getFieldDetails(Long id);

优点：无需额外配置，JPQL会自动处理类型映射，直接返回符合接口的动态代理对象。

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