使用@EmbeddedId创建JPA多对多关联实体插入报错如何解决

核心问题：对@MapsId的作用方向理解有误 #

@MapsId的作用是告知JPA：当前关联属性对应的ID值会自动同步到@EmbeddedId的对应字段，而非从@EmbeddedId中读取值反向填充关联属性。
你使用的EclipseLink实现生成SQL插入语句时，默认读取@ManyToOne关联属性对应的@JoinColumn值作为插入数据源，而非直接读取嵌入式主键的字段。所以你只填充了FooBarKey的字段值时，foo和bar属性为null，自然会报无法插入null值的错误。

两种正确使用方案，无需同时设置主键和关联对象 #

方案1：仅设置关联对象（推荐）

符合面向对象操作习惯，不需要手动维护嵌入式主键，JPA会自动填充FooBarKey的对应属性：

// foo和bar均为已持久化对象
FooBar fb = new FooBar();
fb.setFoo(foo);
fb.setBar(bar);
fb.setDesc("Some Random Text");

entityManager.persist(fb);

方案2：仅设置嵌入式主键（按需选择）

如果业务场景需要直接操作主键字段，可修改FooBar类的关联注解，标记关联字段为只读，告知JPA插入/更新时不需要从关联属性取值，直接使用嵌入式主键的字段值：

@Entity
@Table(name ="FOO_BAR_XREF")
public class FooBar implements Serializable {

  @EmbeddedId
  private FooBarKey key;
  
  @MapsId("fooId")
  @ManyToOne
  // 新增insertable、updatable属性
  @JoinColumn(name = "FOO_ID", referencedColumnName = "FOO_ID", insertable = false, updatable = false)
  private Foo foo;

  @MapsId("barId")
  @ManyToOne
  // 新增insertable、updatable属性
  @JoinColumn(name = "BAR_ID", referencedColumnName = "BAR_ID", insertable = false, updatable = false)
  private Bar bar;  
  
  @Column(name = "DESC")
  private String desc; 
  
  // 其余代码不变
}

修改配置后，你原本仅填充FooBarKey的代码就可以正常运行，不需要再设置foo和bar关联属性。这种方式的缺点是需要手动维护主键ID和关联对象的一致性，容易出现数据不一致的问题。

补充说明 #

你现有的配置本身没有错误，之前同时设置主键和关联对象能正常运行，是因为此时关联属性有值，JPA读取关联对象的ID生成插入语句，且主键值和关联对象ID一致没有冲突。

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