Spring Boot JPA如何自动生成带自定义属性的多对多关联表

标准JPA规范本身不支持无关联实体的多对多关联表新增自定义字段，以下方案基于Hibernate实现，无需单独创建独立的关联实体类文件，保留原有自动建表配置即可生成符合要求的关联表： #

调整代码实现 #

1. 修改SearchRequest实体类 #

替换原有@ManyToMany关联的persons字段，新增内嵌复合映射类和集合字段：

@NoArgsConstructor
@RequiredArgsConstructor(staticName = "of")
@Getter
@Setter
@Entity
@EqualsAndHashCode
@Table(name = "search_requests")
public class SearchRequest {

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    @JsonProperty(access = JsonProperty.Access.READ_ONLY)
    private Long id;

    // 内嵌映射类，无需单独创建实体文件
    @Embeddable
    @Data
    @NoArgsConstructor
    @AllArgsConstructor(staticName = "of")
    public static class PersonStudyBind {
        @ManyToOne(fetch = FetchType.LAZY, optional = false)
        @JoinColumn(name = "person_id")
        private Person person;

        @Column(name = "study_id", nullable = false)
        private Integer studyId;
    }

    // 替换原有@ManyToMany的persons字段
    @ElementCollection
    @CollectionTable(
        name = "search_requests_persons", // 关联表名和原有保持一致
        joinColumns = @JoinColumn(name = "search_request_id", nullable = false)
    )
    private List<PersonStudyBind> personBinds;

    // 可选：保留原有获取关联Person列表的便捷方法
    public List<Person> getPersons() {
        return personBinds.stream()
                .map(PersonStudyBind::getPerson)
                .toList();
    }
}

2. 原有Person实体无需修改 #

不需要保留注释掉的private List<Integer> studyIds字段，studyId统一在关联的内嵌类中维护即可。 #

效果验证 #

保留原有spring.jpa.hibernate.ddl-auto=update配置，项目启动后Hibernate会自动生成search_requests_persons关联表，包含三个字段：

• search_request_id：关联搜索请求表主键
• person_id：关联人员表主键
• study_id：新增的业务字段

操作示例 #

新增关联关系时直接操作personBinds集合即可：

// 示例：给搜索请求关联人员，同时指定studyId
Person person = personRepository.findById(1L).get();
searchRequest.getPersonBinds().add(SearchRequest.PersonStudyBind.of(person, 1001));
searchRequestRepository.save(searchRequest);

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