JPA生成复合主键问题：如何让role_permissions表以id为主键？

问题原因 #

你当前的代码存在配置冲突：

• 在Role和Permission类中，通过@ManyToMany注解指定了关联表role_permissions，JPA默认会为这种多对多关联生成以两个外键（role_id、permission_id）组成的复合主键。
• 同时你又单独定义了RolePermission实体类，试图将id作为该表的主键。

JPA在处理这种冲突时，会优先识别@ManyToMany注解的规则，导致自定义的id主键被忽略，还错误地给role_id添加了serial序列（因为JPA误以为这是关联表的自增主键字段）。

解决方案 #

要让role_permissions表以id作为主键，必须完全用自定义的RolePermission实体来维护多对多关系，去掉Role和Permission中的@ManyToMany注解，改用@OneToMany关联到RolePermission。

修改后的实体类代码 #

1. Role类（替换原@ManyToMany）

@Getter
@Setter
@Entity
@Table(name = "roles")
@NoArgsConstructor
public class Role extends BaseEntity {
    @Column(nullable = false, unique = true, updatable = false)
    private String name;

    @Column(nullable = false)
    private int level;

    // 一对多关联RolePermission，mappedBy指定关联字段在RolePermission中的属性名
    @OneToMany(mappedBy = "role", cascade = CascadeType.ALL, orphanRemoval = true)
    private Set<RolePermission> rolePermissions = new LinkedHashSet<>();

    public Role(String name, int level) {
        this.name = name;
        this.level = level;
    }

    // 便捷方法：维护关联关系（可选，但推荐添加）
    public void addPermission(Permission permission) {
        RolePermission rp = new RolePermission(this, permission);
        rolePermissions.add(rp);
        permission.getRolePermissions().add(rp);
    }

    public void removePermission(Permission permission) {
        rolePermissions.removeIf(rp -> rp.getPermission().equals(permission));
        permission.getRolePermissions().removeIf(rp -> rp.getRole().equals(this));
    }
}

2. Permission类（替换原@ManyToMany）

@Getter
@Entity
@Table(name = "permissions")
public class Permission extends BaseEntity {
    @Column(nullable = false, unique = true)
    private String name;
    @Column(nullable = false)
    private String displayName;

    // 一对多关联RolePermission
    @OneToMany(mappedBy = "permission", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<RolePermission> rolePermissions = new ArrayList<>();

    protected Permission() {
    }

    public Permission(String name, String displayName) {
        this.name = name;
        this.displayName = displayName;
    }
}

3. RolePermission类（保留并优化）

@Getter
@Entity
@Table(name = "role_permissions")
public class RolePermission {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int id;

    @ManyToOne(optional = false)
    @JoinColumn(name = "role_id") // 显式指定外键列名，避免JPA自动生成歧义字段
    private Role role;

    @ManyToOne(optional = false)
    @JoinColumn(name = "permission_id") // 显式指定外键列名
    private Permission permission;

    protected RolePermission() {
    }

    public RolePermission(Role role, Permission permission) {
        this.role = role;
        this.permission = permission;
    }
}

修改后的效果 #

JPA会根据RolePermission实体生成正确的数据表：

• id字段作为主键，使用IDENTITY自增策略
• role_id和permission_id作为普通外键，关联到roles和permissions表
• 不会生成复合主键，也不会给role_id添加错误的serial序列

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