Spring Data JPA关联实体部分加载与乐观锁更新问题咨询

问题1：加载指定SomeEntity，仅关联最新10条AnotherEntity（单次请求） #

首先需要修正实体关联：当前是单向@OneToMany，会生成中间表，无法直接通过AnotherEntity反向关联SomeEntity，建议改为双向关联，便于后续查询和维护：

// 修改SomeEntity的@OneToMany配置
@OneToMany(mappedBy = "someEntity", cascade = CascadeType.PERSIST) // 级联保存新关联实体
private List<AnotherEntity> anotherEntities = new ArrayList<>();

// 在AnotherEntity添加反向关联
@Data
@Entity
public class AnotherEntity {
    @Id
    private Long id;

    @Column
    private String someField;
    
    @Column
    private Long version;

    @ManyToOne(fetch = FetchType.LAZY) // 懒加载避免不必要的性能开销
    @JoinColumn(name = "some_entity_id")
    private SomeEntity someEntity;
}

之后在Spring Data JPA Repository中添加自定义查询，通过FETCH JOIN结合子查询实现单次请求加载主实体+部分关联数据：

public interface SomeEntityRepository extends JpaRepository<SomeEntity, Long> {

    @Query("SELECT se FROM SomeEntity se " +
           "LEFT JOIN FETCH se.anotherEntities ae " +
           "WHERE se.id = :id " +
           "AND ae.id IN (" +
               "SELECT ae2.id FROM AnotherEntity ae2 " +
               "WHERE ae2.someEntity.id = :id " +
               "ORDER BY ae2.id DESC LIMIT 10" +
           ")")
    SomeEntity findByIdWithLatest10AnotherEntities(@Param("id") Long id);
}

如果要保持单向关联不变，可使用PostgreSQL原生SQL查询：

@Query(value = "SELECT se.*, ae.* " +
               "FROM some_entity se " +
               "LEFT JOIN some_entity_another_entities se_ae ON se.id = se_ae.some_entity_id " +
               "LEFT JOIN another_entity ae ON se_ae.another_entities_id = ae.id " +
               "WHERE se.id = :id " +
               "ORDER BY ae.id DESC LIMIT 10",
       nativeQuery = true)
SomeEntity findByIdWithLatest10AnotherEntitiesNative(@Param("id") Long id);

问题2：添加新AnotherEntity时避免原有数据丢失，同时触发乐观锁 #

核心原则：不要直接修改脱离持久化上下文的detached实体，而是在事务中获取托管状态的实体（或代理）后执行修改，Hibernate只会同步变更部分，不会覆盖未加载的关联集合。

方案1：使用getReference获取代理（性能最优）

getReference返回实体代理，不会立即查询数据库，仅在需要时初始化，适合仅修改关联集合的场景：

@Service
@Transactional
public class SomeEntityService {
    private final SomeEntityRepository someEntityRepo;

    public void addAnotherEntity(Long someEntityId, AnotherEntity newEntity) {
        // 获取SomeEntity代理，不会触发数据库查询
        SomeEntity managedEntity = someEntityRepo.getReferenceById(someEntityId);
        // 设置双向关联
        newEntity.setSomeEntity(managedEntity);
        // 添加新实体到集合
        managedEntity.getAnotherEntities().add(newEntity);
        // 事务提交时Hibernate自动同步变更，@Version字段自动更新触发乐观锁
    }
}

方案2：加载实体但不初始化关联集合

如果需要操作实体的其他字段，可利用懒加载特性避免加载全部关联数据：

@Service
@Transactional
public class SomeEntityService {
    private final SomeEntityRepository someEntityRepo;

    public void addAnotherEntity(Long someEntityId, AnotherEntity newEntity) {
        // 加载SomeEntity，集合默认懒加载，不会查询关联数据
        SomeEntity managedEntity = someEntityRepo.findById(someEntityId)
                .orElseThrow(() -> new IllegalArgumentException("SomeEntity不存在"));
        newEntity.setSomeEntity(managedEntity);
        managedEntity.getAnotherEntities().add(newEntity);
        // 事务提交时自动同步，乐观锁自动生效
    }
}

关键注意事项：

1. 确保@OneToMany配置了cascade = CascadeType.PERSIST（或ALL），新的AnotherEntity会被级联保存。
2. @Version字段自动触发乐观锁：事务中修改托管实体时，Hibernate会在更新时校验版本号，版本不匹配则抛出OptimisticLockingFailureException。
3. 禁止直接修改问题1中查询返回的部分加载实体后调用save，这会导致Hibernate认为集合已被替换，删除原有未加载的关联数据。

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