Spring JPA原生查询忽略空参数触发bigint=bytea类型报错

报错本质是PostgreSQL强类型校验和Hibernate对null参数类型推导失效共同导致的：

• 非null场景下，你传入的Long类型fulfilmentId能被Hibernate正确识别为JDBC BIGINT类型，和表字段的int8（bigint）类型匹配，查询正常执行。
• 当传入null值时，Hibernate无法从null值推断出对应的JDBC类型，会默认将该参数标记为bytea（二进制类型）。此时SQL中fulfilment_id = ?的比较就变成了bigint和bytea类型做相等判断，PostgreSQL没有对应类型的等于运算符，直接抛出类型不匹配的语法错误。

你写的条件判断逻辑(fulfilment_id is null OR :fulfilmentId is null OR fulfilment_id = :fulfilmentId)本身没有问题，问题出在null参数没有显式指定类型。用-1作为默认值的方案确实能绕开报错，但属于临时补丁，既增加了不必要的逻辑分支，未来如果业务中出现-1的合法值还会引发数据错误，不建议长期使用。

按推荐优先级从高到低排列：

1. 显式声明参数类型（最优解，无额外逻辑侵入） #

在@Param注解中明确指定参数对应的Java类型，让Hibernate即使拿到null值也能正确映射JDBC类型，修改代码如下：

@Query(value = "SELECT * FROM fulfilment_acknowledgement WHERE entity_id = :entityId " +
            "and item_id = :itemId " +
            "and (fulfilment_id is null OR :fulfilmentId is null OR fulfilment_id = :fulfilmentId) " +
            "and type = :type", nativeQuery = true)
FulfilmentAcknowledgement findFulfilmentAcknowledgement(
    @Param("entityId") String entityId,
    @Param("itemId") String itemId,
    @Param(value = "fulfilmentId", type = Long.class) Long fulfilmentId,
    @Param("type") String type
);

如果使用Hibernate 6及以上版本，也可以直接在原生SQL中给参数加类型强转，不修改注解配置：

and (fulfilment_id is null OR :fulfilmentId::bigint is null OR fulfilment_id = :fulfilmentId::bigint)

2. 改用动态查询构造（适合多可选过滤参数场景） #

如果后续这类可空的查询参数越来越多，不要硬写固定SQL的条件分支，直接使用JPA的JpaSpecificationExecutor构造动态查询，仅当参数非null时才拼接对应的过滤条件，从根源上避免null参数传参问题，同时减少无效条件判断，更利于数据库索引命中。

3. 默认值兼容方案（仅临时应急用） #

如果暂时无法修改查询定义，可以在业务层传参前判断，给null的fulfilmentId赋值一个业务上绝对不可能出现的bigint值（比如你提到的-1），但必须在代码旁加清晰注释，说明这个赋值是为了绕开Hibernate类型推导bug，避免后续维护人员误删或引入业务值冲突问题。

避坑提醒：不要为了简化逻辑把条件改成fulfilment_id IS NOT DISTINCT FROM :fulfilmentId，这个写法在参数为null时依然会触发相同的类型不匹配错误，必须先解决null参数的类型映射问题。

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