Spring Data JPA无法获取AppUser关联的Role数据问题

实体关联关系 #

• AppUser 与 Profile 为一对一关联（1个AppUser对应1个Profile）
• AppUser 与 Post 为一对多关联（1个AppUser对应多个Post，1个Post仅归属1个AppUser）
• AppUser 与 Role 为多对多关联

实体类代码 #

AppUser #

@Getter
@Setter
@Entity
@Table(name = "app_user")
public class AppUser {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(name = "username")
    private String username;

    @Column(name = "email")
    private String email;

    @JsonManagedReference
    @OneToOne(cascade = CascadeType.ALL, fetch = FetchType.EAGER)
    @JoinColumn(name = "profile_id")
    private Profile profile;

    @JsonManagedReference
    @OneToMany(mappedBy = "appUser", cascade = CascadeType.ALL, fetch = FetchType.EAGER)
    private List<Post> posts = new ArrayList<>();

    @JsonBackReference
    @ManyToMany
    @JoinTable(
            name = "user_role",
            joinColumns = @JoinColumn(name = "user_id"),
            inverseJoinColumns = @JoinColumn(name = "role_id")
    )
    private Set<Role> roles = new HashSet<>();
}

Profile #

@Getter
@Setter
@Entity
@Table(name = "profile")
public class Profile {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String bio;
}

Post #

@Getter
@Setter
@Entity
@Table(name = "post")
public class Post {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String content;

    @JsonBackReference
    @ManyToOne
    @JoinColumn(name = "app_user_id")
    private AppUser appUser;
}

Role #

@Getter
@Setter
@Entity
@Table(name = "role")
public class Role {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;

    @ManyToMany(mappedBy = "roles")
    private Set<AppUser> appUsers = new HashSet<>();
}

问题现象 #

调用userRepository.findAll()查询所有用户时，返回结果中缺失Role相关数据，响应示例如下：

// http://localhost:8080/user/all

[
  {
    "id": 1,
    "username": "john_doe",
    "email": "john@gmail.com",
    "profile": {
      "id": 1,
      "bio": "This is John Doe's bio."
    },
    "posts": [
      {
        "id": 1,
        "content": "Content of post 1"
      },
      {
        "id": 2,
        "content": "Content of post 2"
      }
    ]
  },
  {
    "id": 2,
    "username": "jane_smith",
    "email": "jane@gmail.com",
    "profile": {
      "id": 2,
      "bio": "This is Jane Smith's bio."
    },
    "posts": [
      {
        "id": 3,
        "content": "Content of post 3"
      }
    ]
  }
]

原因分析 #

1. 懒加载默认行为：JPA中@ManyToMany关联默认的FetchType为LAZY（懒加载），即只有主动调用roles集合的方法时才会从数据库加载数据。序列化JSON时，懒加载集合未被初始化，因此不会被序列化输出。
2. JSON注解问题：AppUser的roles字段标注了@JsonBackReference，该注解会在序列化时忽略当前属性（用于避免循环引用），直接导致Role数据无法出现在响应中。

解决方案 #

方案1：调整FetchType与JSON注解 #

修改AppUser的roles字段，移除@JsonBackReference并指定FetchType.EAGER，同时在Role的appUsers字段添加@JsonBackReference避免循环引用：

修改后的AppUser部分代码：

@ManyToMany(fetch = FetchType.EAGER)
@JoinTable(
        name = "user_role",
        joinColumns = @JoinColumn(name = "user_id"),
        inverseJoinColumns = @JoinColumn(name = "role_id")
)
private Set<Role> roles = new HashSet<>();

修改后的Role部分代码：

@JsonBackReference
@ManyToMany(mappedBy = "roles")
private Set<AppUser> appUsers = new HashSet<>();

方案2：使用JPQL主动关联查询 #

在UserRepository中定义自定义查询方法，通过JOIN FETCH主动加载Role数据：

@Repository
public interface UserRepository extends JpaRepository<AppUser, Long> {
    @Query("SELECT u FROM AppUser u JOIN FETCH u.roles")
    List<AppUser> findAllWithRoles();
}

调用findAllWithRoles()替代findAll()即可获取包含Role的用户数据。

方案3：使用EntityGraph加载关联属性 #

在UserRepository的findAll()方法上添加@EntityGraph注解，指定要加载的关联属性：

@Repository
public interface UserRepository extends JpaRepository<AppUser, Long> {
    @Override
    @EntityGraph(attributePaths = {"roles"})
    List<AppUser> findAll();
}

此方式会让JPA自动生成查询语句，一次性加载用户及其关联的Role数据。

注意事项 #

• 避免滥用FetchType.EAGER，当关联数据量较大时，会导致查询性能下降。
• 处理多对多关联的JSON序列化时，确保@JsonManagedReference和@JsonBackReference配对正确，防止循环引用或数据丢失。

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