如何在Spring JPA多对多自动映射表中添加自定义列？

Hibernate自动生成的隐式多对多关联中间表无法直接添加额外字段，必须将这种关联拆分为两个显式的一对多关联，通过创建中间实体类来实现自定义中间表结构。

步骤1：创建中间实体类 #

新建对应中间表的实体类（比如UserConnection），在这个类中定义需要的额外列，同时关联两端的MyUsers实体。

示例代码：

@Getter @Setter @NoArgsConstructor @AllArgsConstructor
@Table(name = "my_users_connections") // 保持原中间表名称，或按需修改
public class UserConnection {
    // 可选：用单独主键，或复合主键（见下文）
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;

    // 关联发起关联的用户
    @ManyToOne
    @JoinColumn(name = "my_users_id", nullable = false)
    private MyUsers user;

    // 关联被关联的用户
    @ManyToOne
    @JoinColumn(name = "connections_id", nullable = false)
    private MyUsers connection;

    // 额外列示例1：关联创建时间
    @Column(nullable = false)
    private LocalDateTime createdAt;

    // 额外列示例2：关联类型（如"好友"/"关注"）
    private String connectionType;
}

如果需要保证user和connection的组合唯一（避免重复关联），可以使用复合主键：

// 先定义复合主键类，需实现Serializable接口
@Getter @Setter @NoArgsConstructor @AllArgsConstructor
public class UserConnectionId implements Serializable {
    private Long user; // 对应UserConnection中user的主键字段名
    private Long connection; // 对应UserConnection中connection的主键字段名
}

// 修改中间实体类
@Getter @Setter @NoArgsConstructor @AllArgsConstructor
@Table(name = "my_users_connections")
@IdClass(UserConnectionId.class)
public class UserConnection {
    @Id
    @ManyToOne
    @JoinColumn(name = "my_users_id", nullable = false)
    private MyUsers user;

    @Id
    @ManyToOne
    @JoinColumn(name = "connections_id", nullable = false)
    private MyUsers connection;

    @Column(nullable = false)
    private LocalDateTime createdAt;

    private String connectionType;
}

步骤2：修改原MyUsers实体类 #

将原来的@ManyToMany关联替换为两个@OneToMany关联，分别对应当前用户作为发起方和接收方的关联关系：

@Getter @Setter @NoArgsConstructor @AllArgsConstructor
@Table(name = "my_users")
public class MyUsers {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    @Column(nullable = false)
    private Long id;

    @Column(nullable = false, unique = true)
    private String userName;
    private String password;

    // 当前用户发起的所有关联
    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<UserConnection> initiatedConnections = new ArrayList<>();

    // 当前用户收到的所有关联
    @OneToMany(mappedBy = "connection", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<UserConnection> receivedConnections = new ArrayList<>();

    // 可选：添加便捷方法，简化关联操作
    public void addConnection(MyUsers targetUser, String connectionType) {
        UserConnection connection = new UserConnection();
        connection.setUser(this);
        connection.setConnection(targetUser);
        connection.setCreatedAt(LocalDateTime.now());
        connection.setConnectionType(connectionType);
        initiatedConnections.add(connection);
        targetUser.getReceivedConnections().add(connection);
    }
}

原理说明 #

原来的@ManyToMany是Hibernate帮你隐式生成中间表，没有对应的实体类，因此无法直接扩展字段。通过显式创建中间实体类，将多对多拆分为MyUsers -> UserConnection和UserConnection -> MyUsers两个一对多关联，就能完全自定义中间表的结构，添加任意需要的额外列，同时也能更灵活地操作中间表的数据。

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