JPA/Spring中@JoinColumn关联已有主键与复合主键字段报错求助

错误原因 #

Server类中serverId字段既是主键，又被@JoinColumn重复映射到数据库的serverId列，Hibernate判定同一列被多个属性绑定，触发映射异常。

解决方案 #

方案1：通过License端维护关联（推荐） #

因为License的复合主键已包含serverId，直接在License类中关联Server，Server端用mappedBy关联，避免重复映射列。

修改后的代码如下：

Server类

import jakarta.persistence.*;

@Entity
@Table(name = "server")
public class Server {

    @Id
    private String serverId;

    // 由License端的server属性维护关联关系
    @OneToOne(mappedBy = "server")
    private License license;
    
    // getter and setter
}

License类

import jakarta.persistence.*;

@Entity
@Table(name = "license")
public class License {

    @EmbeddedId
    private LicenseKey id;

    // 关联Server，使用复合主键中的serverId作为外键
    @OneToOne
    @JoinColumn(name = "serverId", referencedColumnName = "serverId", insertable = false, updatable = false)
    private Server server;
    
    // getter and setter
}

LicenseKey类

import jakarta.persistence.Embeddable;
import java.io.Serializable;
import java.util.Objects;

@Embeddable
public class LicenseKey implements Serializable {
    private String version;
    private String serverId;

    // 必须实现Serializable的要求：添加无参构造、重写equals和hashCode
    public LicenseKey() {}

    public LicenseKey(String version, String serverId) {
        this.version = version;
        this.serverId = serverId;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        LicenseKey that = (LicenseKey) o;
        return Objects.equals(version, that.version) && Objects.equals(serverId, that.serverId);
    }

    @Override
    public int hashCode() {
        return Objects.hash(version, serverId);
    }

    // getter and setter
}

方案2：Server端维护关联（需调整表结构） #

如果业务需要在Server端主动关联License，需确保Server表存在version列，同时对重复映射的列标记不可插入/更新：

import jakarta.persistence.*;

@Entity
@Table(name = "server")
public class Server {

    @Id
    private String serverId;

    // Server表需新增version列
    @Column(name = "version")
    private String version;

    @OneToOne
    @JoinColumns({
        // 主键字段已映射serverId，此处标记不可操作
        @JoinColumn(name = "serverId", referencedColumnName = "serverId", insertable = false, updatable = false),
        // version列由当前字段和关联字段共同映射，标记不可操作
        @JoinColumn(name = "version", referencedColumnName = "version", insertable = false, updatable = false)
    })
    private License license;
    
    // getter and setter
}

注意事项 #

• 复合主键类LicenseKey必须实现Serializable，且提供无参构造、重写equals和hashCode方法，否则Hibernate无法正确处理主键匹配。
• 一对一关联需确保数据唯一性：License表中serverId字段应添加唯一约束，避免一个Server对应多个License。

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