JPA自定义原生查询无匹配数据返回含null元素列表问题排查

• 验证原生SQL实际执行结果
  把传入的ids参数代入查询语句，在数据库客户端直接执行SELECT a, b, c, d FROM table WHERE a in ('参数1','参数2')，确认实际返回结果：如果SQL本身就返回了全为null的行，说明是数据源侧问题，比如表中存在全null的脏数据、查询的表是视图且关联逻辑导致无匹配时返回null行。
• 对比异常接口和正常接口的差异
  重点核对以下几项配置：
  • 异常接口是否使用了native = true原生查询，正常接口是否用的JPQL，原生查询的结果映射规则和JPQL存在差异
  • Row类映射配置是否正确：如果是实体类，有没有加@Entity注解，字段上@Column的name属性是否和SQL返回列名完全一致（大小写也要匹配，部分数据库对列名大小写敏感）；如果是接口投影，检查getter方法名是否和列名对应，或者@Value注解指定的列名是否正确
  • 有没有配置自定义的@SqlResultSetMapping结果映射，映射规则写错会导致无数据时强制填充null元素
• 检查JPA配置
  确认是否开启了hibernate.return_null_on_empty_collection这类特殊配置，或者有没有全局自定义的ResultTransformer，导致空结果被强制填充了null元素。
• 校验入参值
  打印传入的ids参数，确认是否传入了空列表：部分JPA版本处理IN条件传入空列表时，会生成WHERE a in ()的非法SQL，错误返回全null结果，而非抛出异常或返回空列表。

• 入参为空的场景：调用接口前先判断ids是否为空，为空直接返回空列表，无需调用JPA接口；也可以在查询语句中增加空判断逻辑，比如WHERE (size(:ids) = 0 OR a in (:ids))，原生查询需要适配对应数据库的空列表判断语法。
• 映射不匹配的场景：给Row类的每个字段加上明确的@Column(name = "实际列名")注解，和SQL返回列名完全对齐；也可以修改SQL给列加别名匹配实体字段，比如SELECT a as a, b as b, c as c, d as d FROM table WHERE a in (:ids)。
• 原生查询映射问题的场景：可以去掉native = true改为JPQL查询，用实体映射的字段名编写查询语句，避免原生查询的大小写、列名匹配问题。
• 数据库返回全null行的场景：在SQL末尾加过滤条件，比如AND a IS NOT NULL过滤掉全null的无效行。

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