Spring Data JPA避坑指南:99%新手踩过的坑我都帮你填平了!

liuian 2025-07-08 20:04 29 浏览

Spring Data JPA 让开发者摆脱了繁琐的 SQL 编写，但新手稍不留神就会掉进性能黑洞、数据异常、甚至生产事故的深坑。你以为 save() 就是万能的？分页排序内存处理很优雅？N+1 问题只是传说？ 本文将用真实代码场景撕开这些假象，直击 6 个高频致命坑点。

一、N+1 查询：你的接口慢如蜗牛的元凶

错误示范：天真使用 findAll()

@Entity
public class User {
    @OneToMany(mappedBy = "user")
    private List<Order> orders; // 默认FetchType.LAZY
}

// 调用代码
List<User> users = userRepository.findAll();
users.forEach(user -> {
    System.out.println(user.getOrders().size()); // 触发N+1查询！
});

现象：查询1次用户表 + N次订单表（用户数量=N）。
解析：LAZY加载模式下，遍历访问关联对象会触发额外查询。

正确方案：强制预加载

// 方案1：JPQL + FETCH JOIN
@Query("SELECT u FROM User u LEFT JOIN FETCH u.orders")
List<User> findAllWithOrders();

// 方案2：@EntityGraph 显式指定关联
@EntityGraph(attributePaths = "orders")
List<User> findAll();

二、事务失效：你的@Transactional 为何不生效？

错误示范：非public方法使用事务

@Transactional
private void updateUser(Long id) { // 事务失效！
    userRepository.updateName(id, "newName");
}

关键点：Spring AOP 代理无法拦截私有方法，事务注解失效。

正确方案：遵守事务方法规范

// 1. 方法必须public
@Transactional
public void batchUpdate() {
    // 业务操作
}

// 2. 避免自调用（同类中调用带事务的方法）
// 错误：this.internalUpdate(); 应通过代理对象调用

三、更新操作：save() 不是万能的！

错误场景：全量更新导致数据丢失

User user = userRepository.findById(1L).orElseThrow();
user.setName("Jack");
userRepository.save(user); // 若其他字段为null，会被覆盖！

陷阱：若实体中存在未加载的字段（如 LAZY 属性），save() 会覆盖整个记录。

正确方案：动态更新

// 1. 使用@DynamicUpdate（仅Hibernate有效）
@Entity
@DynamicUpdate
public class User { ... }

// 2. 显式调用update（推荐）
@Modifying
@Query("UPDATE User u SET u.name = :name WHERE u.id = :id")
void updateName(@Param("id") Long id, @Param("name") String name);

四、分页与排序：内存分页等于自杀

错误示范：先查全量再分页

List<User> users = userRepository.findAll();
List<User> pageList = users.stream()
                          .skip(0).limit(10)
                          .collect(Collectors.toList()); // 内存爆炸！

后果：10万条数据加载到内存，分页效率极低。

正确方案：数据库分页

Pageable pageable = PageRequest.of(0, 10, Sort.by("createTime"));
Page<User> page = userRepository.findAll(pageable); // 仅查10条

五、动态查询：Specification 不是银弹

错误场景：复杂条件拼接

Specification<User> spec = (root, query, cb) -> {
    List<Predicate> predicates = new ArrayList<>();
    if (condition1) predicates.add(cb.like(...));
    if (condition2) predicates.add(cb.between(...));
    // 动态拼接10个条件...
    return cb.and(predicates.toArray(new Predicate[0]));
};

痛点：条件复杂时代码可读性差，难以维护。

推荐方案：使用QueryDSL

// 自动生成Q类，类型安全
BooleanBuilder builder = new BooleanBuilder();
if (name != null) builder.and(qUser.name.eq(name));
if (age > 0) builder.and(qUser.age.gt(age));
userRepository.findAll(builder);

六、懒加载陷阱：LazyInitializationException 的幽灵

错误场景：会话关闭后访问关联对象

@Transactional
public void processUser(Long id) {
    User user = userRepository.findById(id).orElseThrow();
    // 事务结束，Session关闭
}

// 外部调用
processUser(1L);
user.getOrders().size(); // 抛出异常！

解决方案：DTO投影或保持事务

// 方案1：使用DTO提前加载
@Query("SELECT new com.example.UserDTO(u.id, u.name, SIZE(u.orders)) FROM User u")
List<UserDTO> findUserStats();

// 方案2：OpenSessionInView（谨慎使用）
spring.jpa.open-in-view=true // 在Web请求中保持Session