Hibernate抛出无效列异常原因解析：Oracle正常Java代码报错

这问题我之前也碰到过！核心原因其实是Hibernate原生查询的实体映射规则和Oracle的查询行为不一致导致的，咱们一步步拆解：

问题本质 #

Oracle执行SQL时，只关心语法是否正确，返回的结果集别名是什么它根本不在乎——只要你写的SQL合法，它就会返回数据。但Hibernate用createNativeQuery(..., Details.class)的时候，会严格把查询返回的列名（也就是你定义的别名）和Details实体类的字段做匹配：如果找不到对应的字段，直接就抛"无效列名"异常。

看你的代码对比 #

你两个查询的区别就是别名：

1. 第一个查询：name as teamName, location as bookingLoc
2. 第二个查询：name as team, location as booking

能正常运行的第二个查询，说明你的Details类里的字段就是team和booking对吧？那第一个查询用teamName和bookingLoc当别名，Hibernate找不到对应的字段，自然就报错了。

几种解决方案 #

根据你的需求选就行：

• 最简单的方案：对齐别名和实体字段名
  就像你第二个查询那样，把SQL里的别名改成和Details类字段完全一致的名字，Hibernate就能自动映射了。
• 不想改SQL？用@Column注解指定映射关系
  在Details类的字段上加上注解，告诉Hibernate这个字段对应查询里的哪个列名：

  public class Details {
      @Column(name = "teamName")
      private String team;
      
      @Column(name = "bookingLoc")
      private String booking;
      // 其他字段和方法
  }
  

• 复杂场景用结果集映射
  如果需要更灵活的映射（比如用构造函数初始化实体），可以用@SqlResultSetMapping：

  @Entity
  @SqlResultSetMapping(
      name = "DetailsCustomMapping",
      classes = @ConstructorResult(
          targetClass = Details.class,
          columns = {
              @ColumnResult(name = "teamName", type = String.class),
              @ColumnResult(name = "bookingLoc", type = String.class)
          }
      )
  )
  public class Details {
      // 构造函数要和上面定义的列顺序一致
      public Details(String team, String booking) {
          this.team = team;
          this.booking = booking;
      }
      // 其他代码
  }
  

  然后调用的时候指定这个映射：

  return (Details) entityManager.createNativeQuery(finalQuery, "DetailsCustomMapping")
      .setParameter("empPSID", psid)
      .getSingleResult();
  

额外注意：Oracle的列名大小写坑 #

Oracle默认会把所有列名（包括别名）转成大写存储，如果你实体字段是驼峰式（比如teamName），而查询里的别名没加双引号，Oracle会把它转成TEAMNAME，Hibernate找teamName字段就会匹配失败。这时候可以给别名加双引号强制保留大小写：

SELECT name as "teamName", location as "bookingLoc" FROM table where emp_ps_id = :empPSID and rownum<2

这样Hibernate就能精准匹配到驼峰字段了。

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