如何通过Spring Data实现一对多关联查询？

先贴下你的实体类方便参考：

Task 实体 #

@Entity
@Data
public class Task {
    @Id
    @GeneratedValue
    private long id;
    private String title;
    private boolean done;
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "user_id")
    private User user;
}

User 实体 #

@Data
@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;
    private String firstName;
    private String lastName;
    @OneToMany(mappedBy = "user")
    private List<Task> tasks;
}

针对这组一对多（User→Task）、多对一（Task→User）的关联，咱们可以用两种核心方式写Spring Data查询：方法命名查询（简单场景首选）和**@Query注解自定义JPQL**（复杂场景更灵活）。下面是常见场景的实现：

1. 根据用户查询其所有任务 #

这是最常用的场景，从Task端关联查询：

• 方法命名写法（直接在TaskRepository里定义）：

  // 根据用户ID查任务
  List<Task> findByUser_Id(Long userId);
  
  // 直接传入User对象查任务
  List<Task> findByUser(User user);
  

• 自定义JPQL写法（适合需要更复杂逻辑的情况）：

  @Query("SELECT t FROM Task t WHERE t.user.id = :userId")
  List<Task> getTasksByUserId(@Param("userId") Long userId);
  

⚠️ 注意：因为Task的user字段是FetchType.LAZY懒加载，如果查询后要在事务外访问task.getUser().getFirstName()这类属性，会抛出LazyInitializationException。解决办法是查询时用JOIN FETCH提前加载关联的User：

@Query("SELECT t FROM Task t JOIN FETCH t.user WHERE t.user.id = :userId")
List<Task> getTasksWithUserByUserId(@Param("userId") Long userId);

2. 根据任务状态查询对应的用户 #

比如要找所有拥有已完成任务的用户：

• 方法命名写法（在UserRepository里定义）：

  // 注意加Distinct，避免同一个用户因多个已完成任务被重复返回
  List<User> findDistinctByTasks_DoneTrue();
  

• 自定义JPQL写法：

  @Query("SELECT DISTINCT u FROM User u JOIN u.tasks t WHERE t.done = true")
  List<User> getUsersWithCompletedTasks();
  

如果要包含“没有任务的用户”，可以用左连接：

@Query("SELECT DISTINCT u FROM User u LEFT JOIN u.tasks t WHERE t.done = true OR t IS NULL")
List<User> getUsersWithCompletedTasksOrNoTasks();

3. 查询某个用户的未完成任务 #

• 方法命名写法：

  List<Task> findByUser_IdAndDoneFalse(Long userId);
  

• 自定义JPQL写法：

  @Query("SELECT t FROM Task t WHERE t.user.id = :userId AND t.done = false")
  List<Task> getUndoneTasksForUser(@Param("userId") Long userId);
  

4. 多条件组合查询（跨关联实体） #

比如查询名字包含“Tom”且任务标题包含“报告”的用户：

• 方法命名写法：

  List<User> findDistinctByFirstNameContainingAndTasks_TitleContaining(String firstNameKeyword, String taskTitleKeyword);
  

• 自定义JPQL写法：

  @Query("SELECT DISTINCT u FROM User u JOIN u.tasks t WHERE u.firstName LIKE %:firstNameKeyword% AND t.title LIKE %:taskTitleKeyword%")
  List<User> getUsersByFirstNameAndTaskTitle(@Param("firstNameKeyword") String firstNameKeyword, @Param("taskTitleKeyword") String taskTitleKeyword);
  

核心规则总结 #

• 方法命名查询遵循Spring Data的命名规范：用findBy开头，关联实体属性用下划线（_）分隔（比如tasks_done对应User的tasks集合里Task的done属性）。
• 涉及关联查询时，记得用DISTINCT避免重复结果（尤其是一对多关联的查询）。
• 懒加载场景下，按需使用JOIN FETCH提前加载关联实体，避免事务外的懒加载异常。

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