如何使用JPA实现含联合主键的弱实体CompanyDetail映射？

核心问题分析 #

你之前尝试在@EmbeddedId外单独标注@Id的方式不可行，因为JPA不允许同时混合使用@EmbeddedId和多个@Id注解定义复合主键。正确的做法是把所有主键字段（company_id + service）都整合到嵌入式主键类中。

具体实现步骤 #

1. 定义包含完整复合主键的嵌入式类 #

创建CompanyDetailPk作为嵌入式主键，同时包含关联Company的主键字段和service字段：

@Embeddable
@Data
public class CompanyDetailPk implements Serializable {
    // 对应Company的主键字段
    private Long companyId;
    // 自身的唯一标识字段
    private String service;

    // JPA要求必须提供无参构造函数
    public CompanyDetailPk() {}

    // 可选：提供带参构造函数简化实例创建
    public CompanyDetailPk(Long companyId, String service) {
        this.companyId = companyId;
        this.service = service;
    }
}

注：嵌入式主键类必须实现Serializable，且重写equals()和hashCode()（Lombok的@Data已自动完成这两项）。

2. 调整CompanyDetail实体 #

使用新的CompanyDetailPk作为@EmbeddedId，并通过@MapsId关联到Company实体：

@Entity
@Data
public class CompanyDetail {
    @EmbeddedId
    private CompanyDetailPk id;

    // 关联Company实体，@MapsId指定用id中的companyId字段映射到Company的主键
    @ManyToOne(fetch = FetchType.LAZY)
    @MapsId("companyId")
    private Company company;

    private String detail;

    // JPA要求的无参构造函数
    public CompanyDetail() {}

    // 业务构造函数，方便创建实例
    public CompanyDetail(Company company, String service, String detail) {
        this.id = new CompanyDetailPk(company.getId(), service);
        this.company = company;
        this.detail = detail;
    }
}

3. 确保Company实体的映射正确 #

Company实体保持原有结构，使用CompanyPk作为嵌入式主键，也可添加对CompanyDetail的双向关联：

@Entity
@Data
public class Company {
    @EmbeddedId
    private CompanyPk id;

    // 可选：双向关联CompanyDetail，级联操作保证数据一致性
    @OneToMany(mappedBy = "company", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<CompanyDetail> details = new ArrayList<>();

    // JPA要求的无参构造函数
    public Company() {}

    // 业务方法：添加详情
    public void addDetail(String service, String detail) {
        CompanyDetail companyDetail = new CompanyDetail(this, service, detail);
        this.details.add(companyDetail);
    }
}

方案合理性说明 #

• 完全符合JPA复合主键规范：通过@EmbeddedId封装所有主键字段，避免了注解混用的冲突。
• 贴合你对弱实体的定义：CompanyDetail的主键由关联实体（Company）的主键+自身属性（service）组成，无法单独标识自身。
• 天然满足业务约束：(company_id, service)作为复合主键，自动保证同一家公司下的service字段唯一。

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