PostgreSQL：查询参数为Null时出现bigint与varchar类型不匹配错误

错误原因分析 #

根据异常信息ERROR: operator does not exist: bigint = character varying，核心问题是**FK_SUPP_FIELD_REC_ID（数据库bigint类型）与传入的第二个参数类型不兼容**，同时SQL中判断NULL的写法错误（用= null而非标准的IS NULL）。日志里显示的FK_SUPP_FIELD_REC_ID = null是参数绑定后的错误生成语句，实际是传入的参数类型为字符串（比如误传了字符串"null"），或EclipseLink未正确转换参数类型导致类型冲突。

可行解决方案 #

1. 修正NULL比较逻辑+匹配参数类型

将查询语句调整为正确的NULL判断逻辑，同时确保传入的第二个参数是Long/BigInteger类型（对应PostgreSQL的bigint），而非字符串：

SELECT * 
FROM AGX_ADDITIONAL_SUPP_FIELDS  
WHERE DB_COLUMN = ?1 
  AND (?2 IS NULL AND FK_SUPP_FIELD_REC_ID IS NULL OR FK_SUPP_FIELD_REC_ID = ?2)

该逻辑会在参数为NULL时判断字段是否为NULL，参数非NULL时执行等值比较，既避免了无效的= null判断，也保证类型匹配时的正常比较。

2. 显式强制转换参数类型

如果无法确保参数类型正确传入，可在SQL中显式转换参数类型，解决类型不兼容问题：

SELECT * 
FROM AGX_ADDITIONAL_SUPP_FIELDS  
WHERE DB_COLUMN = ?1 
  AND (?2 IS NULL AND FK_SUPP_FIELD_REC_ID IS NULL OR FK_SUPP_FIELD_REC_ID = CAST(?2 AS bigint))

3. 在EclipseLink中指定参数类型

使用setParameter时显式声明参数的JDBC类型，强制EclipseLink按正确类型绑定：

ReadAllQuery query = new ReadAllQuery(AdditionalSupplementFields.class);
query.setSQLString("SELECT * FROM AGX_ADDITIONAL_SUPP_FIELDS WHERE DB_COLUMN = ?1 AND (?2 IS NULL AND FK_SUPP_FIELD_REC_ID IS NULL OR FK_SUPP_FIELD_REC_ID = ?2)");
// 指定第二个参数为BIGINT类型
query.setParameter(1, dbColumnValue);
query.setParameter(2, fkSuppFieldRecId, JDBCType.BIGINT);

4. 检查实体类映射

确认AdditionalSupplementFields实体中对应FK_SUPP_FIELD_REC_ID的字段类型为Long或BigInteger，且JPA注解与数据库字段匹配：

@Entity
@Table(name = "AGX_ADDITIONAL_SUPP_FIELDS")
public class AdditionalSupplementFields {
    // 其他字段...
    @Column(name = "FK_SUPP_FIELD_REC_ID", columnDefinition = "bigint")
    private Long fkSuppFieldRecId;
    // getter/setter...
}

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