Spring Boot启动时初始化JPA关联数据报detached entity异常解决

Spring Boot应用启动阶段通过ApplicationRunner执行初始化逻辑：

1. 向Role表插入ADMIN、CUSTOMER两条角色数据
2. 创建1个管理员账号，为其分配ADMIN角色
   实际运行时，只要给User实体设置角色关联就抛出异常，移除角色赋值逻辑后程序可正常运行，需要确认三个疑问：

• 是否是角色数据未持久化到数据库就直接关联用户导致报错
• 上述初始化操作是否在同一事务中执行
• 异常的根本原因是什么

原实现代码如下：

@RequiredArgsConstructor
@Component
public class AppStartupRunner implements ApplicationRunner {
    private final RoleRepository roleRepository;
    private final BCryptPasswordEncoder bCryptPasswordEncoder = new BCryptPasswordEncoder();
    private final UserRepository userRepository;

    @Override
    public void run(ApplicationArguments args) throws Exception {
        Role role = new Role();
        role.setName("ADMIN");
        Role role2 = new Role();
        role2.setName("CUSTOMER");
        roleRepository.save(role);
        roleRepository.save(role2);

        User user = new User();
        user.setUserStatus(UserStatus.ACTIVE);
        user.setUserType(UserType.ADMIN);
        user.setPhoneNumber("05355485476");
        user.setPassword(bCryptPasswordEncoder.encode("123456789e"));
        user.setEmail("david@gmail.com");
        user.setName("David");
        user.getRoles().add(role);
        user.setCreatedAt(new Date());
        userRepository.save(user);
    }
}

抛出的核心异常：

org.springframework.dao.InvalidDataAccessApiUsageException: detached entity passed to persist: com.example.bankapp.entity.Role; nested exception is org.hibernate.PersistentObjectException: detached entity passed to persist: com.example.bankapp.entity.Role

• 是否是角色未持久化就关联导致报错？
  不是。代码中已经显式调用两次roleRepository.save()将两个角色写入数据库，角色数据确实完成了持久化，不存在未入库就关联的问题。
• 初始化操作是否在同一事务中执行？
  不在。Spring Data JPA默认给Repository的每个写操作方法绑定独立事务，方法执行完立刻提交事务、关闭持久化上下文。上述代码中两次保存角色、一次保存用户的三个save()调用，分别属于三个完全独立的事务，没有共用同一个持久化会话。
• 异常根本原因是什么？
  根因是传入持久化操作的Role实体处于游离（脱管）状态，触发了JPA的持久化规则校验：
  1. 调用roleRepository.save(role)时，role对象在当前save方法的独立事务内会成为持久态（被EntityManager管理），但save方法执行完事务提交后，EntityManager关闭，role对象直接从持久态转为游离态——它虽然已经有数据库生成的主键ID，但和后续保存用户时的持久化会话没有任何关联。
  2. 从报错可以推断，你在User和Role的关联关系上配置了CascadeType.PERSIST（或者CascadeType.ALL，默认包含PERSIST级联），保存User时JPA会自动对关联的Role实体执行persist级联操作。
  3. JPA的persist操作只接受*瞬时态（刚new出来、没有主键ID、未被持久化过）*的实体，传入带主键的游离态实体时，就会直接抛出detached entity passed to persist异常。
     移除角色赋值后程序能正常运行，就是因为保存User时没有需要级联处理的关联实体，不会触发对游离Role的persist校验。

除了你找到的data.sql脚本初始化方案，用代码初始化还有两种更简便的改法：

1. 给run方法加事务注解
   给run()方法添加@Transactional注解，把所有初始化逻辑包裹在同一个事务中，三次save()操作会共用同一个持久化上下文，存完角色后Role实体始终处于持久态，不会出现游离问题：

   @Override
   @Transactional // 新增这行注解即可
   public void run(ApplicationArguments args) throws Exception {
       // 原有业务逻辑不需要修改
   }
   

2. 修正级联配置+重新获取持久态角色
   Role属于系统基础数据，本身不应该被User的操作级联影响，建议把User-Role关联上的CascadeType.PERSIST/CascadeType.ALL去掉，避免不合理的级联操作。保存用户前重新获取持久态的ADMIN角色关联即可：

   // 存完两个角色后，不要直接使用之前new出来的游离态role对象
   Role adminRole = roleRepository.getReferenceById(role.getId());
   user.getRoles().add(adminRole);
   userRepository.save(user);
   

你找到的脚本初始化方案是可行的，两个配置的作用分别是：

• spring.jpa.defer-datasource-initialization=true：调整执行顺序，让JPA先完成表结构创建（比如Hibernate自动建表），再执行data.sql脚本，避免脚本执行时表还不存在报错。
• spring.sql.init.mode=always：强制每次启动都执行SQL脚本，不管当前是不是内嵌数据库。

注意：该方案默认每次启动都会重复执行插入语句，自增主键场景下重复启动会报主键冲突，适合仅首次初始化的场景，或者给插入语句加重复判断逻辑。生产环境建议把这个配置改成never，避免误执行脚本污染数据。

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