Spring Data JPA保存子实体时同步更新父实体字段失败如何解决

问题根因 #

• 级联触发时机不匹配：你当前保存的是全新的UserProfile实体，Spring Data JPA的save()方法会判断实体为新增状态，底层调用EntityManager.persist()执行插入，而你在子实体的@OneToOne关联上仅配置了CascadeType.MERGE和CascadeType.REFRESH，persist流程只会触发配置了CascadeType.PERSIST的级联操作，因此父实体的修改不会被同步到数据库。
• 游离态父实体存在数据覆盖风险：你手动通过builder构建的existingUser是游离态对象，仅填充了userId字段，其他字段均为默认的null，即便触发了级联更新，也会把父实体表中已有的name、email等字段覆盖为null，引发数据丢失。

最优解决方案（无数据风险，无需修改实体配置） #

不需要调整现有实体的级联配置，只要先从数据库查询出托管态的父实体，修改后再关联子实体保存即可，步骤如下：

1. 测试类注入UserRepository
2. 执行操作前先查询已存在的用户实体，确保是持久化上下文托管的对象
3. 修改父实体字段后关联子实体保存

修改后的测试代码如下：

@SpringBootTest
class UserProfileRepositoryTest {

    @Autowired
    private UserProfileRepository userProfileRepository;
    // 新增注入UserRepository
    @Autowired
    private UserRepository userRepository;

    private Random random = new Random();
    private User existingUser;
    private UserProfile newUserProfile;

    @BeforeEach
    void setUp() {
        String id = String.format("%04d", random.nextInt(10000));
        newUserProfile = UserProfile.builder()
                .firstName("Brijesh")
                .lastname("Yadav")
                .phoneNumber(id)
                .status((byte) 1)
                .description("This is just for testing UserProfileRepository")
                .createdBy(1L)
                .updatedBy(1L)
                .createdOn(ZonedDateTime.now())
                .updatedOn(ZonedDateTime.now())
                .build();
    }

    @Test
    public void createProfileAndUpdateUser() {
        // Given
        // 先查询托管态的已存在用户，避免手动构建的游离对象问题
        existingUser = userRepository.findById(1L)
                .orElseThrow(() -> new RuntimeException("指定ID的用户不存在"));
        // 修改父实体字段，此时父实体处于托管状态，修改会被持久化上下文感知
        existingUser.setUpdatedBy(2L);
        existingUser.setUpdatedOn(ZonedDateTime.now());
        UserProfile testUserProfile = newUserProfile;
        testUserProfile.setUser(existingUser);

        // When
        UserProfile result = userProfileRepository.save(testUserProfile);

        // Then
        assertThat(result).isNotNull();
        assertThat(result.getProfileId()).isGreaterThan(0);
    }

}

这个方案是最稳妥的，不会出现字段覆盖的问题，托管态父实体的修改会在事务提交时自动同步到数据库，不需要额外的级联配置。

可选方案（仅适合父实体字段完整的场景） #

如果你确实需要通过子实体级联触发父实体更新，需要做两处调整：

1. 保存子实体时主动触发merge流程，代替默认的persist流程：

@Autowired
private EntityManager entityManager;

// 保存时替换userProfileRepository.save为merge调用
UserProfile result = entityManager.merge(testUserProfile);

2. 必须保证你手动构建的existingUser所有字段都有正确的值，不能只填userId，否则会把未赋值的字段更新为null。

注意：这个方案风险较高，除非有特殊需求否则不推荐使用。

优化建议 #

你当前的实体类使用了@Data注解，该注解会自动生成包含所有字段的equals、hashCode、toString方法，对于带关联关系的JPA实体，容易触发懒加载异常、破坏持久化上下文的判断逻辑，建议换成@Getter、@Setter、@ToString（手动排除关联字段）的组合，避免隐性问题。

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