Hibernate一对多映射重复列错误排查与解决求助

问题根源分析 #

你遇到的两个核心问题：

1. 重复列映射错误：SocietyBlockFloor实体中，society_id列既被标记为主键（@Id），又被用作关联SocietyDetails的外键（@JoinColumn），Hibernate不允许同一列被重复映射，所以抛出Repeated column in mapping for entity错误。
2. 关联查询字段不匹配：你修改了主键字段名但没同步调整映射的列名，或者关联逻辑没更新，导致查询时仍引用不存在的societyId字段。

解决方案步骤 #

1. 修正SocietyBlockFloor实体映射

首先要把主键和外键列分开，子表的主键应该是独立的唯一标识，外键单独用一列关联父表主键：

package com.example.domain;
import javax.persistence.*;
import java.io.Serializable;

@Entity
@Table(name="society_block_floor")
public class SocietyBlockFloor implements Serializable {
    public static final long serialVersionUID = 1L;

    // 改用独立的主键列，比如society_block_floor_id
    @Id
    @Column(name="society_block_floor_id")
    private String societyBlockFloorId;

    @Column(name="society_block")
    private String societyBlock;

    @Column(name="society_floor")
    private String societyFloor;

    // 关联父表的外键列，这里用society_id，和主键列分开
    @ManyToOne
    @JoinColumn(name = "society_id", nullable = false, insertable = false, updatable = false)
    private SocietyDetails societyDetails;

    // 手动维护外键值的字段，映射到同一列
    @Column(name = "society_id", nullable = false)
    private String societyId;

    // Getters & Setters
    @Override
    public String toString() {
        return "SocietyBlockFloor{" +
                "societyBlockFloorId='" + societyBlockFloorId + '\'' +
                ", societyBlock='" + societyBlock + '\'' +
                ", societyFloor='" + societyFloor + '\'' +
                ", societyDetails='" + societyDetails + '\'' +
                ", societyId='" + societyId + '\'' +
                '}';
    }

    public String getSocietyBlockFloorId() {
        return societyBlockFloorId;
    }

    public void setSocietyBlockFloorId(String societyBlockFloorId) {
        this.societyBlockFloorId = societyBlockFloorId;
    }

    public String getSocietyBlock() {
        return societyBlock;
    }

    public void setSocietyBlock(String societyBlock) {
        this.societyBlock = societyBlock;
    }

    public String getSocietyFloor() {
        return societyFloor;
    }

    public void setSocietyFloor(String societyFloor) {
        this.societyFloor = societyFloor;
    }

    public SocietyDetails getSocietyDetails() {
        return societyDetails;
    }

    public void setSocietyDetails(SocietyDetails societyDetails) {
        this.societyDetails = societyDetails;
        // 同步设置外键值
        if (societyDetails != null) {
            this.societyId = societyDetails.getSocietyId();
        }
    }

    public String getSocietyId() {
        return societyId;
    }

    public void setSocietyId(String societyId) {
        this.societyId = societyId;
    }
}

2. 确认SocietyDetails的关联设置保持正确

你的SocietyDetails里的@OneToMany映射是正确的，mappedBy="societyDetails"指定由子表维护关联关系，无需修改：

@OneToMany(mappedBy = "societyDetails", cascade = CascadeType.ALL)
private List<SocietyBlockFloor> societyBlockFloor = new ArrayList<SocietyBlockFloor>();

3. 修正JPQL查询语句

原来的查询语句可以优化，同时确保关联逻辑正确：

@Override
public List<SocietyDetails> getSocietyDetailsByName(String societyName) throws Exception {
    try {
        // 使用fetch join避免N+1查询，同时关联逻辑更清晰
        String queryString = "SELECT DISTINCT society FROM SocietyDetails society " +
                            "JOIN FETCH society.societyBlockFloor " +
                            "WHERE society.societyName = :societyName";
        Query query = getSessionFactory().getCurrentSession().createQuery(queryString);
        query.setParameter("societyName", societyName);
        List<SocietyDetails> societyDetails = query.list();
        return societyDetails;
    } catch (Exception e) {
        e.printStackTrace();
        throw e;
    }
}

关键说明 #

• 主键与外键分离：子表不能将外键列同时作为主键（除非是复合主键场景，但这里每个楼层应该有自己的唯一ID），否则会导致映射冲突。
• insertable=false, updatable=false：当同一列被映射为实体字段和关联外键时，需要设置关联字段的这两个属性，告诉Hibernate由实体字段来维护该列的插入和更新，避免冲突。
• FETCH JOIN：使用JOIN FETCH可以一次性加载关联的SocietyBlockFloor数据，避免后续懒加载导致的额外查询，提升性能。

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