使用JPA原生查询返回多表连接列时遇空指针问题求助

1. 核对投影接口与查询列的映射 #

• 确保EvaluatedResult接口的getXXX()方法名和查询返回的列名严格匹配（JPA默认按驼峰转下划线规则映射，比如getCampaignId()对应查询列campaign_id）。如果查询用了别名，别名必须和方法名的下划线转驼峰结果一致，别写错大小写或名称。
• 别用基本类型接收可能为NULL的列：比如查询列可能为空，接口方法就用Integer而不是int，避免拆箱时抛NPE。

2. 检查原生查询的JPA兼容性 #

• 必须给@Query注解加上nativeQuery = true，同时确认查询里的表名、列名和实体@Table/@Column映射的数据库表/列完全一致（比如实体映射的表是campaigns，查询里就不能写campaign）。
• 开启SQL日志对比实际执行语句：在配置文件里加这两行，看JPA实际跑的SQL和你在Workbench里的是不是完全一样，有没有参数替换错误或者拼写问题：

  spring.jpa.show-sql=true
  spring.jpa.properties.hibernate.format_sql=true
  

3. 确认Repository方法的返回类型 #

• 方法返回类型必须是List<EvaluatedResult>（或单个EvaluatedResult），不能用List<Object[]>之类的类型，否则JPA没法正确转成投影接口实例。
• 如果方法返回单个EvaluatedResult，但查询可能无结果，最好改成Optional<EvaluatedResult>，避免直接返回NULL导致调用时抛NPE。

4. 检查实体关联的映射正确性 #

• 核对Campaign、Question等实体的@JoinColumn、@OneToMany等关联注解的列名，和数据库实际外键列完全一致，别出现实体里写campaign_id但数据库里是campaignId的情况。

5. 换用构造函数投影试试 #

如果投影接口始终有问题，换成DTO类（带全参构造函数），用JPQL的构造函数查询方式：
比如先写DTO类：

public class EvaluatedResultDTO {
    private Integer campaignId;
    private String questionText;
    // 其他字段

    public EvaluatedResultDTO(Integer campaignId, String questionText) {
        this.campaignId = campaignId;
        this.questionText = questionText;
    }
    // 对应getter方法
}

然后Repository里写JPQL查询（注意用实体属性名，不是数据库列名）：

@Query("SELECT new com.yourpackage.EvaluatedResultDTO(c.id, q.text) FROM Campaign c JOIN c.questions q ...")
List<EvaluatedResultDTO> getEvaluatedResults();

6. 定位NPE的具体触发点 #

• 用断点调试，看NPE是在调用Repository方法时抛出，还是处理返回结果时抛的。如果是处理结果时，可能是你直接调用了投影方法返回的NULL值的方法（比如result.getCampaignId().intValue()，但getCampaignId()返回NULL）；如果是调用方法时抛的，检查投影接口是不是public的，方法是不是标准getXXX()格式。

内容的提问来源于stack exchange，提问作者Thomas A Mathew