JPA Repository使用原生查询出现Invalid column error该如何处理

报错的核心原因是：你使用原生查询仅返回了TN_COMMENTS表的自有字段，但Comment实体中通过复合主键关联了Flag实体作为commentType属性，JPA在将查询结果映射为Comment实体时，会尝试查找关联Flag所需的两个主键字段对应的返回值，你的原生查询未返回这两个字段，因此触发17006Invalid column name错误。

可根据业务需求选择以下任意一种方案处理：

• 方案1：原生查询补充关联映射字段
  按照JPA嵌套属性的别名规则，在原生查询中手动补充关联Flag需要的两个字段，修改后的查询代码如下：

  @Query( value = "SELECT c.*, " +
          "'COMMENT_CHANGED_FLAG' as commentType_flagId_flagName, " +
          "c.COMMENT_CHANGED_FLAG as commentType_flagId_flagValue " +
          "FROM tn_comments c " +
          "JOIN tn_s_target_types t on t.code = c.target_type " +
          "WHERE c.target_type = ?1 AND c.target_id = ?2 ",
          nativeQuery = true)
  List<Comment> getCommentsByTargetTypeAndTargetId(String targetType, Long targetId);
  

  别名规则说明：commentType是Comment实体中的关联属性名，flagId是Flag实体的嵌入式主键属性名，flagName/flagValue是FlagId类中的属性名，用下划线连接属性层级后，JPA可自动识别映射关系。

• 方案2：改用JPQL查询，自动处理关联
  如果没有强制使用原生SQL的需求，直接改用JPQL查询即可，JPA会自动处理关联字段的加载逻辑，无需手动补全字段：

  @Query("SELECT c FROM Comment c WHERE c.targetType.code = :targetType AND c.targetId = :targetId")
  List<Comment> getCommentsByTargetTypeAndTargetId(@Param("targetType") String targetType, @Param("targetId") Long targetId);
  

• 方案3：调整关联加载策略避免映射
  如果当前业务场景完全不需要用到commentType字段，可以在@OneToOne注解上配置懒加载策略fetch = FetchType.LAZY，或者使用Spring Data JPA投影功能仅返回需要的业务字段，跳过未查询的关联属性映射。

• 额外检查项：确认数据库TN_COMMENTS表中实际存在COMMENT_CHANGED_FLAG字段，字段名拼写、大小写和注解中配置的一致，部分大小写敏感的数据库也会因为字段名不匹配触发该错误。

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