Spring Boot：如何通过单API调用创建关联的嵌套实体？

问题背景 #

我们有User和Account两个资源，二者为一对一关联关系，分别存储在不同数据库表中。业务要求所有API调用必须同时操作这两个实体，比如创建带Account的User时，向/users发送POST请求，请求体格式如下：

{ "name" : "Joe Bloggs", "account" : { "title" : "My Account" }}

不采用users/1/account这类分路由的多控制器方案，因为无论内部存储结构如何，都需要将User视为单一整体对象。

当前使用的Entity类定义如下：

@Table(name = "user")
public class User {

  @OneToOne(mappedBy = "user", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
  @NotNull
  Account account;

  @Column(name = "name")
  String name;
}

@Table(name = "account")
public class Account {

  @OneToOne(cascade = CascadeType.ALL, optional = false, fetch = FetchType.LAZY)
  @JoinColumn(name = "user_id", nullable = false)
  @NotNull
  User user;

  @Column(name = "title")
  String title;
}

遇到的问题：发送上述POST请求时会报错，原因是Account表所需的user_id字段缺失，但此时User还未创建完成，无法提供该主键值。需要找到通过单API调用同时创建两个实体的可行方案。

解决方案 #

方案一：手动建立双向关联+调整级联配置 #

当前关联中，Account是关联维护方（持有@JoinColumn注解），但由于User未持久化时无法生成主键，导致Account的user_id无法填充。我们可以通过手动绑定双向关联+调整级联配置解决：

1. 修改实体类：

   • 移除Account类中@OneToOne的cascade = CascadeType.ALL，避免循环级联问题，仅保留User类的级联配置（保存User时会自动级联保存Account）。
   • 在User的setAccount方法中，手动将当前User对象设置给Account，完成双向绑定。

   修改后的实体代码：

   @Table(name = "user")
   public class User {
   
     @OneToOne(mappedBy = "user", cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
     @NotNull
     Account account;
   
     @Column(name = "name")
     String name;
   
     // 构造器、getter省略
     public void setAccount(Account account) {
         this.account = account;
         account.setUser(this); // 手动绑定双向关联
     }
   }
   
   @Table(name = "account")
   public class Account {
   
     @OneToOne(optional = false, fetch = FetchType.LAZY)
     @JoinColumn(name = "user_id", nullable = false)
     @NotNull
     User user;
   
     @Column(name = "title")
     String title;
   
     // 构造器、getter省略
     public void setUser(User user) {
         this.user = user;
     }
   }
   

2. 业务层处理逻辑：
   在创建User的Service方法中，先构建User和Account对象，通过User的setAccount完成双向绑定，再调用Repository保存User即可：

   @Service
   public class UserService {
       @Autowired
       private UserRepository userRepository;
   
       public User createUser(UserCreateRequest request) {
           User user = new User();
           user.setName(request.getName());
   
           Account account = new Account();
           account.setTitle(request.getAccount().getTitle());
   
           user.setAccount(account); // 自动完成双向关联绑定
   
           return userRepository.save(user);
       }
   }
   

   保存User时，Hibernate会因为级联配置自动保存Account，此时User已生成主键，Hibernate会自动将该主键填充到Account的user_id字段，解决缺失问题。

方案二：调整关联维护方到User（可选） #

如果数据库设计还未定型，可以将关联维护方改为User，让User表存储account_id字段，这样保存User时Hibernate会自动先创建Account，再回填关联ID：

修改后的实体代码：

@Table(name = "user")
public class User {

  @OneToOne(cascade = CascadeType.ALL, orphanRemoval = true, fetch = FetchType.LAZY)
  @JoinColumn(name = "account_id", nullable = false)
  @NotNull
  Account account;

  @Column(name = "name")
  String name;
}

@Table(name = "account")
public class Account {

  @OneToOne(mappedBy = "account", fetch = FetchType.LAZY)
  User user;

  @Column(name = "title")
  String title;
}

这种情况下，直接调用userRepository.save(user)即可完成两个实体的创建，无需手动绑定双向关联（但建议还是绑定以保证内存中对象模型的完整性）。

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