JPA共享主键一对一关联时重复条目异常问题及解决方法

我按照如下共享主键建模示例实现了JPA一对一关联：

@Entity
@Table(name = "users")
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    @Column(name = "id")
    private Long id;

    //...

    @OneToOne(mappedBy = "user", cascade = CascadeType.ALL)
    @PrimaryKeyJoinColumn
    private Address address;

    //... getters and setters
}

@Entity
@Table(name = "address")
public class Address {

    @Id
    @Column(name = "user_id")
    private Long id;

    //...

    @OneToOne
    @MapsId
    @JoinColumn(name = "user_id")
    private User user;
   
    //... getters and setters
}

但当address表中已存在id为123456的记录时，尝试通过以下代码更新该记录：

Address po = new Address();
po.setId(123456L);
po.setCountry("TW");
AddressRepository.save(po);

却出现了Duplicate entry '123456' for key异常。请问为何JPA执行插入而非合并操作？该如何解决此问题？

Spring Data JPA的save()方法逻辑是：若实体处于EntityManager管理的持久化状态，则执行更新；若为游离状态的新对象（比如直接new出来的实例），会依赖上下文判断执行插入或合并。

你的Address实体通过@MapsId绑定了User的主键，此时JPA会认为这个未关联User的新Address对象是一条全新记录——因为它无法通过关联关系确认数据库中是否存在对应主键的Address，所以默认执行插入，导致主键重复异常。

另外，只有当EntityManager缓存了该主键的实体，或者通过主键查询到实体存在时，save()才会触发合并操作。你直接new的Address既不在EntityManager的管理中，也没有关联User，JPA无法判断记录是否存在，因此走插入逻辑。

• 方案一：先查询再更新
  先通过主键加载已存在的Address实体，修改属性后保存。此时实体处于持久化状态，JPA会自动执行更新：

  Address existingAddr = addressRepository.findById(123456L)
      .orElseThrow(() -> new RuntimeException("Address not found"));
  existingAddr.setCountry("TW");
  addressRepository.save(existingAddr);
  

• 方案二：关联对应的User实例
  由于Address的主键依赖User的主键，加载对应的User对象关联到Address后，JPA能识别到该记录可能存在，会执行合并操作：

  Address po = new Address();
  po.setId(123456L);
  User user = userRepository.findById(123456L)
      .orElseThrow(() -> new RuntimeException("User not found"));
  po.setUser(user);
  po.setCountry("TW");
  addressRepository.save(po);
  

• 方案三：手动使用EntityManager合并
  若不想查询实体，可以用EntityManager手动合并，同时通过getReference()懒加载User避免额外查询：

  @Autowired
  private EntityManager entityManager;
  
  Address po = new Address();
  po.setId(123456L);
  po.setCountry("TW");
  User user = entityManager.getReference(User.class, 123456L);
  po.setUser(user);
  Address mergedAddr = entityManager.merge(po);
  entityManager.flush();
  

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