Spring Boot JPA多对多映射问题：按用户ID查项目无数据返回

问题分析 #

关联表已创建但查询返回的Project中assignUser无数据，主要是集合未初始化、级联配置不合理、查询未触发关联加载这几个原因导致。

具体解决步骤 #

1. 初始化集合字段，避免null值 #

Kotlin Data Class中关联集合默认是null，JPA无法将关联数据存入null集合，需将assignUser和projects初始化为空MutableSet：

data class Project(
  @Id
  @GeneratedValue
  val id: Long? = null,
  @ManyToMany(fetch = FetchType.EAGER, cascade = [CascadeType.ALL])
  @JoinTable(
    name = "project_user",
    joinColumns = [JoinColumn(name = "project_id", referencedColumnName = "id")],
    inverseJoinColumns = [JoinColumn(name = "user_id", referencedColumnName = "id")]
  )
  var assignUser: MutableSet<Users> = mutableSetOf(),
)

@Entity
@Table(name = "users")
data class Users(
  @Id
  @GeneratedValue(strategy = GenerationType.AUTO)
  val id: Long? = null,
  val firstname: String? = null,
  val lastname: String? = null,
  @ManyToMany(mappedBy = "assignUser", fetch = FetchType.EAGER)
  val projects: MutableSet<Project> = mutableSetOf(),
)

注：JoinColumn的nullable=true和updatable=true是默认值，可省略。

2. 调整级联配置（Inverse端移除不必要的Cascade） #

Users是多对多的Inverse端（由Project维护关联），不需要设置CascadeType.ALL——级联操作应仅由Owning端（Project）负责，Inverse端的级联可能导致关联数据加载异常。

3. 优化查询，强制加载关联集合 #

即使设置了FetchType.EAGER，部分场景下JPA不会自动加载关联集合，需显式指定：

方式一：修改自定义JPQL，使用JOIN FETCH

@Query("SELECT p FROM Project p JOIN FETCH p.assignUser u WHERE u.id = :userId")
fun findProjectsByUserId(userId: Long): List<Project>

方式二：给推导查询添加@EntityGraph注解

@EntityGraph(attributePaths = ["assignUser"])
fun findProjectsByAssignUser_Id(userId: Long): List<Project>

4. 验证关联数据的保存逻辑 #

必须通过Owning端（Project）维护关联关系，才能确保关联表正确插入数据：

// 保存用户
val user = usersRepository.save(Users(firstname = "Pankaj", lastname = "Sharma"))
// 创建项目并关联用户
val project = Project()
project.assignUser.add(user)
// 保存项目（自动维护关联表）
projectRepository.save(project)

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