Hibernate多对多关联保存报SQLIntegrityConstraintViolationException外键错误如何解决

错误根因分析 #

• Book实体主键未配置自增策略：当前Book的id字段仅添加了@Id注解，未配置主键生成策略，日志中可以看到保存时Book的id为int类型的默认初始值0。如果你的tbl_book表id是自增主键，此时插入书籍时没有正确生成有效id，导致插入中间表时传入的book_id是无效值，触发外键约束失败。
• 中间表配置与实际操作的表字段不匹配：你在@JoinTable中定义的中间表名为tblBookAuthors，关联字段名为bookId、authorId，但Hibernate执行的插入语句是向tbl_book_authors表插入book_id、author_id字段，是Hibernate默认的驼峰转下划线命名策略导致注解配置和实际操作的表/字段不匹配。
• 关联的作者对象为游离态：请求反序列化得到的Author对象只有id，没有被JPA持久化上下文管理，直接赋值给Book的authors集合也可能触发关联约束问题。

具体修复步骤 #

步骤1：修正Book主键配置 #

如果你的表主键是数据库自增的，给id字段添加自增策略配置：

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
@Column(name = "id", unique = true, nullable = false)
private int id;

如果业务需要手动传入书籍id，不需要自增，则需要在请求参数中传入合法、未被使用的书籍id，不能使用默认的0。

步骤2：修正中间表配置，统一命名规则 #

二选一即可：

方案A：关闭驼峰转下划线命名策略

在application.properties中添加配置，让Hibernate严格匹配注解定义的名称：

spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl

方案B：修改@JoinTable配置适配下划线命名

@ManyToMany(fetch = FetchType.EAGER)
@JoinTable(name = "tbl_book_authors",
        joinColumns = { @JoinColumn(name = "book_id") },
        inverseJoinColumns = { @JoinColumn(name = "author_id") })
private Set<Author> authors = new HashSet<>();

步骤3：关联持久化的作者对象 #

保存Book之前，先根据传入的作者id查询数据库得到持久化的Author对象，再赋值给Book的authors集合，示例逻辑：

// book为请求反序列化得到的对象
List<Author> managedAuthors = authorRepository.findAllById(
        book.getAuthors().stream().map(Author::getId).collect(Collectors.toList())
);
book.setAuthors(new HashSet<>(managedAuthors));
// 再保存书籍
bookRepository.save(book);

中间表是否需要手动创建 #

如果你配置了spring.jpa.hibernate.ddl-auto为update/create/create-drop，Hibernate会根据@JoinTable的配置自动生成中间表，不需要手动创建。但生产环境建议关闭ddl-auto配置，手动创建中间表保证字段、外键约束完全符合预期。

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