Hibernate分页查询因特殊映射引发‘列名歧义异常’

我之前在处理Hibernate多联合外键+固定层级条件的映射时，也遇到过完全一样的分页查询列名歧义问题，尤其是当存在多个类似关联（比如你这里的element2到element8）时，这个问题会更突出。结合你的场景，我给你几个可行的解决方案，按推荐程度排序：

方案1：移除冗余的String字段，直接通过关联对象操作（最推荐） #

你的核心问题是同时维护了element2（关联对象）和el2（String字段）两个对应同一数据库列的映射，导致Hibernate在分页查询时生成重复列。解决思路是去掉el2/el3这类String字段，直接通过Element关联对象完成插入和更新操作：

修改映射配置 #

调整element2的@JoinColumnsOrFormulas，将EL2列对应的@JoinColumn设置为可插入/更新，同时加上LAZY加载避免分页时自动左连接，提升性能：

@ManyToOne(fetch = FetchType.LAZY)
@JoinColumnsOrFormulas({
    @JoinColumnOrFormula(formula = @JoinFormula(value = "2", referencedColumnName = "ELMLEVEL")),
    @JoinColumnOrFormula(column = @JoinColumn(name = "CMPCODE", referencedColumnName = "CMPCODE", insertable = false, updatable = false)),
    @JoinColumnOrFormula(column = @JoinColumn(name = "EL2", referencedColumnName = "CODE", insertable = true, updatable = true))
})
private Element element2;

同理修改element3到element8的映射，把对应EL3-EL8列的@JoinColumn设置为insertable=true, updatable=true，并加上fetch = FetchType.LAZY。

业务代码中设置字段 #

当需要设置EL2列时，只需要创建一个轻量的Element实例（无需从数据库加载），设置必要属性后赋值给element2：

// 设置EL2值
Element el2 = new Element();
el2.setElmlevel(2); // 对应映射中的固定层级，可省略（因为映射已固定为2）
el2.setCode("目标编码");
// CMPCODE可从company属性获取
el2.setCmpcode(invoice.getCompany().getCmpcode());
invoice.setElement2(el2);

Hibernate在插入/更新时会自动提取element2.code的值写入INVOICE.EL2列，同时关联的ELMLEVEL固定为2、CMPCODE和发票的CMPCODE保持一致。

这个方案从根源上消除了重复字段，分页查询时不会再出现列名歧义，同时代码结构更清晰，也避免了冗余字段的维护。

方案2：保留String字段但标记为@Transient，通过Getter/Setter代理关联对象 #

如果你因为业务习惯或兼容性问题必须保留el2这类String字段，可以将它们标记为@Transient，然后通过Getter/Setter方法间接操作关联对象的属性：

修改实体类代码 #

@ManyToOne(fetch = FetchType.LAZY)
@JoinColumnsOrFormulas({
    @JoinColumnOrFormula(formula = @JoinFormula(value = "2", referencedColumnName = "ELMLEVEL")),
    @JoinColumnOrFormula(column = @JoinColumn(name = "CMPCODE", referencedColumnName = "CMPCODE", insertable = false, updatable = false)),
    @JoinColumnOrFormula(column = @JoinColumn(name = "EL2", referencedColumnName = "CODE", insertable = true, updatable = true))
})
private Element element2;

// 标记为Transient，不参与数据库映射
@Transient
private String el2;

// 重写Getter/Setter
public String getEl2() {
    return element2 != null ? element2.getCode() : null;
}

public void setEl2(String el2) {
    if (element2 == null) {
        element2 = new Element();
        element2.setElmlevel(2);
        element2.setCmpcode(this.getCompany().getCmpcode());
    }
    element2.setCode(el2);
}

这样对外暴露的el2接口完全不变，但底层实际是通过element2操作数据库列，不会产生重复映射的问题，分页查询时也不会出现列名歧义。

方案3：自定义分页查询，避免选择关联列 #

如果上述两种方案都无法实施，你可以通过自定义JPQL查询来控制分页时选择的字段，避免同时选择el2和关联的Element列：

比如在Spring Data JPA的Repository中定义：

@Query("SELECT i.id, i.company, i.el2, i.el3, i.el4, i.el5, i.el6, i.el7, i.el8 FROM Invoice i")
Page<Object[]> findAllCustom(Pageable pageable);

然后在业务层将Object[]转换为Invoice对象。这种方式虽然可行，但代码繁琐，尤其是当字段较多时维护成本很高，仅作为临时解决方案。

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