JPA传入null值时参数类型变为VARBINARY的原因及处理方案

• Spring Data JPA默认使用Hibernate作为持久化实现，原生查询场景下Hibernate的参数类型推断存在逻辑局限：当传入参数值为null时，无法从参数值本身读取类型信息，且原生SQL不会主动解析Repository方法签名上声明的参数类型，会默认将无类型信息的null值兜底绑定为VARBINARY（对应JDBC标准类型Types.VARBINARY），和PostgreSQL的时间类型不匹配时就会抛出类型错误。
• 传入非null时间参数时，Hibernate可以直接通过传入的Java时间对象识别出对应JDBC时间类型，因此会正常绑定为TIMESTAMP类型，不会触发报错。
• 你编写的?1 is null判断逻辑本身在PostgreSQL中语法合法，但参数类型错配会导致数据库无法完成隐式类型转换，最终执行失败。

你可以根据业务场景选择以下任意一种方案解决问题：

• 方案1：显式指定null参数的绑定类型
  调用Repository方法时不要直接传入null，使用Hibernate提供的TypedParameterValue明确声明参数对应的类型，强制Hibernate按指定类型绑定参数，即使值为null也不会回退到VARBINARY类型，示例：

  // 构造对应类型的null参数值，以Instant类型为例
  TypedParameterValue nullInstantParam = new TypedParameterValue(InstantType.INSTANCE, null);
  // 传入方法调用即可
  testRepo.testDates(nullInstantParam, nullZdtParam, nullTsParam, nullLdtParam);
  

• 方案2：使用Specification动态构造查询（推荐）
  对于带可空条件的查询，使用JPA Specification动态拼接SQL谓词是更稳妥的实现方式：当参数为null时直接跳过对应查询条件的拼接，根本不会将null作为参数传入SQL，从根源避免类型绑定问题，示例逻辑：

  public static Specification<XEntity> buildTimeRangeQuery(Instant enrollTime, Instant activeTime) {
      return (root, query, cb) -> {
          List<Predicate> predicateList = new ArrayList<>();
          if (enrollTime != null) {
              predicateList.add(cb.between(root.get("enrollStart"), enrollTime, root.get("enrollEnd")));
          }
          if (activeTime != null) {
              predicateList.add(cb.between(root.get("activeStart"), activeTime, root.get("activeEnd")));
          }
          return cb.and(predicateList.toArray(new Predicate[0]));
      };
  }
  

• 方案3：原生SQL中增加显式类型强转
  如果需要保留硬编码原生SQL的写法，可以在SQL中对参数增加显式类型转换，告知PostgreSQL参数的预期类型，即使绑定的null是VARBINARY类型也能完成正常转换，示例：

  select * 
  from x 
  where (cast(?1 as timestamp) is null or cast(?1 as timestamp) between x.enroll_start and x.enroll_end)
  and (cast(?2 as timestamp) is null or cast(?2 as timestamp) between x.active_start and x.active_end)
  

  注意根据实际Java时间类型匹配PostgreSQL的字段类型，例如ZonedDateTime对应PG的timestamptz类型时，将cast目标类型替换为timestamptz即可。

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