Hibernate实体String字段与PostgreSQL bigint字段不匹配及CAST异常求助

你遇到的核心问题是Java实体类的String类型字段与PostgreSQL的bigint数据库字段类型不匹配，导致查询时触发类型转换异常。下面分两种场景给出具体解决方案：

一、最优方案：修正实体类字段类型（推荐） #

这是最彻底的解决方式，因为PostgreSQL的bigint类型对应Java的Long（若数值超出Long范围可改用BigInteger）是最匹配的，能完全避免类型转换的麻烦。

修改你的实体类代码：

@Entity 
@Table(name="CB_MSG") 
public class Chargeback { 
    // 将原String类型字段改为Long
    @Column(name="CHRGBK_MSG_SEQ_NUM")
    private Long chrgbkMsgSeqNum;

    // 同步修改对应的getter/setter方法
    public Long getChrgbkMsgSeqNum() {
        return chrgbkMsgSeqNum;
    }

    public void setChrgbkMsgSeqNum(Long chrgbkMsgSeqNum) {
        this.chrgbkMsgSeqNum = chrgbkMsgSeqNum;
    }

    // 其他字段与方法...
}

修改完成后，Hibernate会自动处理类型映射，查询时不会再出现类型不兼容的错误。

二、无法修改实体类时的临时解决方案 #

如果因为历史代码依赖等原因不能修改实体字段类型，可以通过以下方式处理查询：

1. 在代码层面转换参数类型（推荐） #

提前将String类型的查询参数转换成Long，再传入查询，避免在SQL层面做转换：

// 假设查询参数是String格式的seqNumStr
String seqNumStr = "123456";
Long seqNum = Long.parseLong(seqNumStr);

// HQL查询示例
Query<Chargeback> query = entityManager.createQuery(
    "SELECT c FROM Chargeback c WHERE c.chrgbkMsgSeqNum = :seqNum", Chargeback.class
);
query.setParameter("seqNum", seqNum);
List<Chargeback> result = query.getResultList();

2. 使用HQL的正确CAST语法 #

你之前用cast(fieldname as bigint)报错，是因为HQL的CAST函数识别的是Java类型或Hibernate内置类型，而非数据库原生类型。应该用long（对应Java的Long类型）来做转换：

String seqNumStr = "123456";
Query<Chargeback> query = entityManager.createQuery(
    "SELECT c FROM Chargeback c WHERE cast(c.chrgbkMsgSeqNum as long) = :seqNum", Chargeback.class
);
query.setParameter("seqNum", Long.parseLong(seqNumStr));
List<Chargeback> result = query.getResultList();

如果使用原生SQL查询，则可以直接用PostgreSQL的原生CAST语法：

Query<Chargeback> query = entityManager.createNativeQuery(
    "SELECT * FROM CB_MSG WHERE cast(CHRGBK_MSG_SEQ_NUM as bigint) = ?", Chargeback.class
);
query.setParameter(1, Long.parseLong(seqNumStr));
List<Chargeback> result = query.getResultList();

3. 自定义Hibernate类型（进阶） #

如果需要全局处理这种String与bigint的映射，可以自定义Hibernate的UserType，实现两种类型之间的自动转换。不过这种方式复杂度较高，仅适合存在大量此类类型映射的场景。

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