Spring 中如何在插入实体时自动插入关联实体（One-To-One）？

建议在带有 @Transactional 的 Service 方法中完成注册时的 Car 创建和分配：手动创建对象、建立关联，再通过 JPA 级联持久化保存。

手动创建 Car 没有问题，这段业务逻辑适合放在 Service 层。题目使用的是自定义 Controller，不建议依靠 @RepositoryEventHandler 完成注册流程。

为什么选择 Service 层

对象的创建和保存需要分别考虑：

• 注册时创建什么车、分配什么资源，属于业务规则。
• 保存 Driver 时是否一并保存关联的 Car，取决于 JPA 映射和级联配置。

@OneToOne 只描述关系。即使配置了 cascade = CascadeType.PERSIST，JPA 也只会持久化已经关联的对象，不会替你执行 new Car()。

把完整的注册过程放在 Service 方法中，Controller、批量导入和其他入口就能复用同一套规则。Spring Data JPA 文档也介绍了这种做法：在完整业务操作的入口设置事务边界。参考 Spring Data JPA 事务说明

实现步骤与代码示例

示例基于以下条件：

• Driver 和 Car 都是本次注册新建的实体。
• 每个 Driver 必须关联一个 Car，同一辆 Car 最多分配给一个 Driver。
• 两者由同一个数据库事务管理。
• 使用 jakarta.persistence；仍使用 javax.persistence 的项目需要调整对应导入。

示例采用单向关联，外键保存在 Driver 表的 car_id 列中。各个类分别放在对应文件中，省略 package 和常规导入。

1. 配置实体关联和级联持久化

@Entity
@Table(name = "drivers")
public class Driver {

    @Id
    @GeneratedValue
    private Long id;

    @Column(nullable = false)
    private String email;

    @OneToOne(
        optional = false,
        cascade = CascadeType.PERSIST
    )
    @JoinColumn(
        name = "car_id",
        nullable = false,
        unique = true
    )
    private Car car;

    protected Driver() {
    }

    public Driver(String email) {
        this.email = email;
    }

    public void assignCar(Car car) {
        this.car = java.util.Objects.requireNonNull(car);
    }

    public Long getId() {
        return id;
    }
}

@Entity
@Table(name = "cars")
public class Car {

    @Id
    @GeneratedValue
    private Long id;

    public Car() {
    }
}

CascadeType.PERSIST 表示持久化 Driver 时，一并持久化它引用的新 Car。

nullable = false 和 unique = true 描述外键列的非空和唯一约束。如果数据库结构由迁移脚本管理，还需要在脚本中建立外键、非空和唯一约束，仅修改实体注解不够。

2. 在事务内完成注册

public interface DriverRepository
        extends JpaRepository<Driver, Long> {
}

@Service
public class DriverRegistrationService {

    private final DriverRepository driverRepository;

    public DriverRegistrationService(
            DriverRepository driverRepository) {
        this.driverRepository = driverRepository;
    }

    @Transactional
    public Long register(String email) {
        Driver driver = new Driver(email);
        Car car = new Car();

        driver.assignCar(car);

        Driver savedDriver = driverRepository.save(driver);
        return savedDriver.getId();
    }
}

示例中的 Driver 使用自动生成的主键，Spring Data JPA 会将它识别为新实体并调用 EntityManager.persist()。关联的 Car 会随之级联持久化，无需额外调用 carRepository.save(car)。

save() 会根据实体的新旧状态选择 persist() 或 merge()。这里的 PERSIST 配置用于新建流程；如果还需要合并脱管实体及其关联对象，应另行评估 CascadeType.MERGE。参考 Spring Data JPA 实体持久化说明

3. Controller 调用注册服务

@RestController
@RequestMapping("/api/register")
public class DriverController {

    private final DriverRegistrationService registrationService;

    public DriverController(
            DriverRegistrationService registrationService) {
        this.registrationService = registrationService;
    }

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public Long register(@RequestParam("email") String email) {
        return registrationService.register(email);
    }
}

示例只返回驾驶员 ID。实际接口可以返回响应 DTO，避免直接序列化整个实体关联图。

为什么不优先使用事件处理器或 @PrePersist

@RepositoryEventHandler 属于 Spring Data REST，处理的是 REST exporter 发布的事件。题目中的自定义 Controller 直接调用 repository.save()，不会自动触发这些事件。

如果通过 Spring Data REST 暴露 Repository，创建前对应的事件处理注解是 @HandleBeforeCreate，不能把 @HandleBeforeSave 当作所有新增操作的统一入口。参考 Spring Data REST 事件说明

即使事件机制适用，把“注册必须分配车辆”的逻辑放在保存事件中，也会让调用者难以看清注册过程。后续增加房屋分配、资格检查或资源选择时，在 Service 中明确组织流程更容易维护。

JPA 的 @PrePersist 也不适合负责这类关联对象的创建和保存。对于可移植的生命周期回调，JPA 规范建议一般不要调用 EntityManager、执行查询，或修改同一持久化上下文中的实体关系。它更适合设置当前实体的创建时间等非关联状态。参考 Jakarta Persistence 生命周期回调规则

扩展到 House、Garage 等实体时如何组织

实体增多后，先区分哪些对象需要在注册时创建，哪些资源需要从已有数据中选择，再确定各自的保存方式。

同时创建、由父对象管理的对象

如果每次注册都要新建 Car 和专属 Garage，可以把对象的组装逻辑提取到工厂中。例如，由 CarFactory 创建 Car 及其内部关联，注册 Service 调用工厂并完成资源分配。

工厂负责构造对象、建立关联，Service 仍负责组织数据库查询、资源分配和事务协调。等逻辑确实变复杂后再拆分即可，简单的 new Car() 可以直接留在注册方法里。

多层级联需要沿关联路径逐层配置。例如，要在持久化 Driver 时一并保存 Car 和 Garage，Driver → Car、Car → Garage 两层关联都需要允许级联 PERSIST。只配置第一层，不会自动覆盖后续所有关联。

已有、共享或独立管理的资源

如果 House、VacationHouse、CleaningTeam 已经存在，注册服务应查询这些资源并建立关联。可以服务多套房屋的 CleaningTeam 尤其不应在每次注册时重新创建，也不应随着 Driver 的删除而被级联删除。

新建实体如果有独立的生命周期，可以先通过它自己的 Repository 显式保存，再建立关联。多个 Repository 操作可以参与同一个 Service 事务，无需为了只调用一次 save()，把所有实体都配置成级联关系。

关系类型也需要符合业务含义。例如，维修历史通常包含多条记录，可能适合 @OneToMany；清洁团队与房屋之间的关系则取决于团队是否共享。参与同一个注册流程，并不意味着它们都应该映射成 @OneToOne。

需要调用外部系统的资源

如果车辆或房屋分配依赖远程服务，本地数据库事务无法直接回滚远程操作，需要明确失败后的补偿或重试方案。

如果业务允许稍后完成分配，可以采用带状态的流程和可靠消息机制，并处理幂等性。这会改变“注册成功时已经分配完成”的承诺，实体的必填关联约束也需要相应调整。

需要注意的几个细节

• CascadeType.ALL 包含删除等操作。如果只需要新增时的级联持久化，使用 PERSIST 即可。是否级联删除，应根据对象的生命周期单独决定。
• orphanRemoval = true 会影响解除关联后对象的删除行为，只有确认子对象由父对象专属管理时才考虑开启。
• 示例使用单向关系。如果改为双向关系，需要同步维护两端引用。mappedBy 指向对方实体中拥有关系的 Java 属性名，数据库关系更新以拥有方的引用为准。参考 JPA 关系拥有方规则
• 调用 save() 时，事务尚不一定提交，所有 SQL 也不一定在这一行执行。约束异常可能到 flush 或提交时才出现。
• @Transactional 需要通过 Spring 管理的事务代理生效。默认情况下，未检查异常会触发回滚；如果注册流程抛出需要回滚的受检异常，应配置相应的回滚规则。
• 应验证关联记录是否保存、外键是否正确，以及注册中途失败后是否留下部分数据。涉及共享资源时，还应验证删除 Driver 不会误删资源。

备注：内容仅供参考。