Spring Boot整合Postgres查询参数为null未返回空结果反而报错如何解决

你遇到的异常本质是SQL执行阶段的类型匹配错误，并非查询无结果时的返回逻辑异常，报错根本没走到结果返回的步骤。错误信息中的operator does not exist: character varying = bytea产生的原因如下：
PostgreSQL对数据类型校验极为严格，当入参webCode或username为null时，Hibernate/PostgreSQL驱动默认会将null值识别为bytea二进制类型，而你表中的WEBCODE、USERNAME字段是varchar字符串类型，两类数据类型无法直接做等值比较，直接抛出SQL语法异常。
你之前在其他数据库（如MySQL）没有遇到类似问题，是因为MySQL对隐式类型转换的兼容度远高于PostgreSQL，会自动处理null值的类型匹配，不会触发语法报错。

以下三种方案可根据你的业务场景选择：

• 方案1：修改原生SQL，显式指定参数类型，同时兼容null参数逻辑
  如果你希望参数为null时，对应的查询条件自动失效，可以直接调整@Query注解中的SQL语句，增加类型转换和null判断：

@Query(value = "select * from notification where (:webCode is null or WEBCODE = cast(:webCode as varchar)) OR (:username is null or USERNAME = cast(:username as varchar))", nativeQuery = true)
Page<NotificationSQL> getNotificationsAsPage(@Param( "webCode" ) String webCode,@Param( "username" ) String username, Pageable pageable);

cast语句会强制将参数转换为varchar类型，避免PostgreSQL识别为bytea类型，同时参数为null时会直接跳过该条件的判断，符合参数非必填的查询需求。

• 方案2：全局配置Hibernate的null参数映射规则
  在项目的application.properties或application.yml中添加如下配置，让Hibernate默认将字符串类型的null参数映射为varchar类型：

# 配置PostgreSQL方言
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
# 配置null值默认映射为varchar类型（对应java.sql.Types.VARCHAR=12）
spring.jpa.properties.hibernate.type.preferred_null_jdbc_type=12

该方案为全局生效，无需修改现有SQL语句，适合有大量类似null参数查询的场景。

• 方案3：使用JPA Specification动态查询
  如果你的查询条件本身就是动态的，可以替换原生SQL为Specification动态拼接逻辑，参数为null时直接不拼接该条件，从根本上避免null参数传入SQL的场景，同时还能兼容更多动态查询的扩展需求。

Spring Data JPA的查询设计中，无匹配结果时，Page类型会返回空Page对象（不为null），List类型会返回空List对象（不为null），本身不会返回null，也不会抛出异常，你之前的认知存在偏差。解决完参数类型问题后，无匹配结果时会正常返回空的Page/List对象。

内容的提问来源于stack exchange，提问作者Gabriel García Garrido