Spring Data JPA新增User时自动插入关联UserDetails的实现方案

你的核心需求是新增User时自动创建对应ID的UserDetails记录，同时要求UserDetails实体仅保留userId字段（不关联User实体）。之前的双向关联配置导致Hibernate操作顺序错误，先尝试保存UserDetails触发外键约束失败，下面是修正后的方案：

修正后的实体配置 #

User实体 #

将User设为关联关系的主控方，通过@PrimaryKeyJoinColumn指定主键关联，同时配置级联操作确保UserDetails随User自动保存：

@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder(toBuilder = true)
@Entity
@Table(name = "user")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private String id;

    private String name;

    // 级联所有操作，删除User时自动删除对应的UserDetails
    @OneToOne(cascade = CascadeType.ALL, orphanRemoval = true)
    // 指定User的主键作为UserDetails的主键关联
    @PrimaryKeyJoinColumn
    // 自动初始化UserDetails实例，无需手动创建
    @Builder.Default
    private UserDetails userDetails = new UserDetails();
}

UserDetails实体 #

仅保留userId作为主键，不添加任何User关联属性，完全符合你的需求：

@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder(toBuilder = true)
@Entity
@Table(name = "user_details")
public class UserDetails {
    @Id
    @Column(name = "user_id")
    private String userId;

    // 可在此添加UserDetails的其他业务字段，如address、phone等
}

为什么之前的配置失败 #

你之前的双向关联配置（User和UserDetails互相引用）会让Hibernate无法确定正确的保存顺序，默认尝试先保存UserDetails，但此时User还未生成UUID，导致外键约束校验失败。同时UserDetails中保留的User属性也不符合你的需求。

验证效果 #

使用Spring Data JPA保存User时，Hibernate会自动执行以下顺序的SQL：

1. 生成UUID并插入user表
2. 使用该UUID作为user_id插入user_details表

测试代码示例：

User user = User.builder()
        .name("Bobby")
        .build();
userRepository.save(user);

执行的SQL与你期望的完全一致：

BEGIN
INSERT INTO user (id, name) VALUES ('自动生成的UUID', 'Bobby');
INSERT INTO user_details (user_id) VALUES ('自动生成的UUID');
COMMIT

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