本文介绍在 spring/jpa 应用中，当 user 实体存在双向自关联（如关注/粉丝关系）时，dto 递归映射引发 stackoverflowerror 的根本原因及专业级解决方案——通过引入中间关联实体 `follows` 拆解循环引用，并配合合理的关系建模与映射策略实现安全、可扩展的数据转换。
在典型的社交系统建模中，User 实体常需表达“关注”（following）与“被关注”（followers）两类对称关系。若直接使用 @ManyToMany 双向映射（如原代码中 friends 与 friedns_of），JPA 会在运行时构建双向对象图；而当 UserMapper::toUser() 采用纯递归方式将 followers 和 following 均映射为嵌套 UserResponse 时，便会触发无限递归调用链——A → B → A → B…，最终抛出 StackOverflowError。
根本问题不在于 JSON 序列化（如 @JsonBackReference 仅作用于 Jackson），而在于Java 对象图映射阶段已发生逻辑循环。因此，解决方案必须从数据模型层面解耦，而非仅依赖序列化注解或懒加载优化。
✅ 推荐做法：引入显式关联实体 Follows
将多对多关系升格为独立实体，不仅规避循环，还支持扩展（如添加关注时间、状态等字段）：
@Entity
@Table(name = "user_follows")
public class Follows {
@EmbeddedId
private FollowsId id;
@MapsId("followerId")
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "follower_id")
private User follower;
@MapsId("userId")
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "user_id")
private User user;
@Column(name = "created_at")
private LocalDateTime createdAt = LocalDateTime.now();
}配套定义复合主键（推荐使用 @Embeddable）：
@Embeddable
public class FollowsId implements Serializable {
private Long followerId;
private Long userId;
// 必须提供无参构造、equals/hashCode、getter/setter
}更新 User 实体，改为单向一对多关联：
@Entity
public class User {
@Id
@GeneratedValue
private Long id;
private String firstName;
private String lastName;
@OneToMany(mappedBy = "user", fetch = FetchType.LAZY)
private List followers = new ArrayList<>();
@OneToMany(mappedBy = "follower", fetch = FetchType.LAZY)
private List following = new ArrayList<>();
// getter/setter...
} 此时 UserMapper 可安全映射，避免递归：
public static UserResponse toUser(User user) {
UserResponse response = new UserResponse();
response.setId(user.getId());
response.setFirstName(user.getFirstName());
response.setLastName(user.getLastName());
// 仅映射 ID 列表（轻量、无循环）
response.setFollowerIds(user.getFollowers().stream()
.map(f -> f.getFollower().getId())
.collect(Collectors.toList()));
response.setFollowingIds(user.getFollowing().stream()
.map(f -> f.getUser().getId())
.collect(Collectors.toList()));
return response;
}? 关键注意事项：
- 永远避免在 DTO 映射中递归调用自身 mapper 方法（如 UserMapper::toUser 调用自身）；
- 若业务确需嵌入部分用户信息（如头像、昵称），应使用 @Query 或 @EntityGraph 预加载有限深度数据，并手动控制映射层级（如仅展开 1 层）；
- FetchType.LAZY 是必要保障，防止 N+1 查询，但需确保在事务上下文中访问关联集合；
- 使用 @EmbeddedId + @MapsId 是 JPA 处理复合外键的最佳实践，比冗余 Long id 字段更语义清晰且节省空间。
该方案兼顾领域建模严谨性、性能可控性与扩展灵活性，是处理自引用关系映射问题的生产级标准解法。
