Hibernate分页报ORA-00918:列定义不明确问题排查

嘿，这个ORA-00918错误我太熟了——本质就是数据库看到查询里有重复的列名，根本搞不清你指的是哪张表的列。结合Hibernate分页的场景（它通常会生成带rownum或者row_number()的嵌套查询），你的实体映射十有八九是下面这些问题之一：

• 关联实体存在同名属性且未做列名区分
  比如你的主实体和它关联的另一个实体（比如通过<many-to-one>或<one-to-many>映射）都有id、create_date这类通用列名。当Hibernate生成分页查询时，会自动关联两张表，但不会给重复列自动添加别名，导致最终SQL里出现两个完全一样的列名，数据库直接懵了。
  举个例子，你的hbm.xml里如果有这样的映射：

  <!-- 主实体Order的映射 -->
  <class name="Order" table="ORDERS">
    <id name="id" column="ID"/>
    <property name="createDate" column="CREATE_DATE"/>
    <many-to-one name="customer" class="Customer" column="CUSTOMER_ID"/>
  </class>
  
  <!-- 关联实体Customer的映射 -->
  <class name="Customer" table="CUSTOMERS">
    <id name="id" column="ID"/>
    <property name="createDate" column="CREATE_DATE"/>
  </class>
  

  当你对Order做分页查询时，Hibernate生成的SQL会同时查询ORDERS.CREATE_DATE和CUSTOMERS.CREATE_DATE，但都显示为CREATE_DATE，数据库就会抛出歧义错误。

• 使用<join>元素时未处理重复列
  如果你的实体用<join>来映射同一张表的扩展字段或者关联另一张表，而两张表存在同名列，又没在<property>里明确指定唯一的列别名或带表限定的列名，也会触发这个问题。比如：

  <class name="User" table="USERS">
    <id name="id" column="ID"/>
    <join table="USER_PROFILES">
      <key column="USER_ID"/>
      <!-- 这里USER_PROFILES表也有CREATE_DATE列，和USERS表重复 -->
      <property name="profileCreateDate" column="CREATE_DATE"/>
    </join>
  </class>
  

  分页查询时，SQL会同时取出USERS.CREATE_DATE和USER_PROFILES.CREATE_DATE，列名重复导致错误。

• HQL分页查询显式引用重复列未加别名
  虽然这看起来是查询写法的问题，但本质也是实体映射没有做列名区分导致的疏忽。比如你写了这样的HQL：

  select o.id, c.id from Order o join o.customer c
  

  然后调用setFirstResult()和setMaxResults()做分页，Hibernate生成的SQL里会有两个ID列，数据库无法区分，直接报错。

对应的解决办法： #

• 给映射里的重复列指定唯一别名或带表限定的列名，比如把Order的createDate改为：

  <property name="orderCreateDate" column="ORDERS.CREATE_DATE"/>
  

  Customer的则改为：

  <property name="customerCreateDate" column="CUSTOMERS.CREATE_DATE"/>
  

• 在HQL分页查询里给重复列显式加别名，比如：

  select o.id as orderId, c.id as customerId from Order o join o.customer c
  

• 对于<join>的场景，确保每个<property>的column属性要么唯一，要么带上表的前缀。

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