Spring Boot 使用 JPA 自引用一对多关系时，因懒加载（Lazy Loading）在事务外失效导致子集合返回 null，需通过 @Transactional 保障关联数据在事务上下文中正确加载。
spring boot 使用 jpa 自引用一对多关系时，因懒加载（lazy loading）在事务外失效导致子集合返回 null，需通过 `@transactional` 保障关联数据在事务上下文中正确加载。
在 Spring Data JPA 中，当实体存在自引用结构（如 Article 同时作为父级和子级），并采用 FetchType.LAZY 加载关联集合（如 subArticles）时，若访问该集合的代码脱离了活跃的数据库事务上下文，JPA 无法初始化代理对象，最终返回 null 或空集合——这正是你截图中 sub_articles 字段缺失的根本原因。
你的 Article 实体中已正确定义了双向关系：
@ManyToOne(fetch = FetchType.LAZY) private Article article; // 父级引用 @OneToMany(fetch = FetchType.LAZY, mappedBy = "article") @JsonProperty(access = JsonProperty.Access.WRITE_ONLY) private Set<Article> subArticles; // 子级集合
但问题出在 mapToArticleDTO 和 findSubArticles 函数中：它们在 findById() 返回 Optional<article></article> 后立即尝试访问 article.getArticle().subArticles()，而此时 JPA Session 已关闭（默认 findById 在方法执行完毕后自动提交/释放事务），subArticles 作为懒加载集合无法被初始化。
✅ 正确做法：将数据转换逻辑移入事务边界内，使用 @Transactional 注解确保整个读取+关联访问过程处于同一事务中：
@RestController
@RequestMapping("/api/v1/article")
public class ArticleController {
@Autowired
private ArticleRepository articleRepository;
@GetMapping("/{id}")
@Transactional // ✅ 关键：保证 subArticles 可被加载
public ResponseEntity<ArticleDTO> getArticle(@PathVariable("id") Long id) {
return articleRepository.findById(id)
.map(this::mapToArticleDTO)
.map(ResponseEntity::ok)
.orElse(ResponseEntity.notFound().build());
}
@GetMapping("/{id}/siblings")
@Transactional // ✅ 同样需要事务支持
public ResponseEntity<Set<ArticleDTO>> getSiblings(@PathVariable("id") Long id) {
return articleRepository.findById(id)
.map(this::findSubArticles)
.map(ResponseEntity::ok)
.orElse(ResponseEntity.notFound().build());
}
private ArticleDTO mapToArticleDTO(Article a) {
return ArticleDTO.builder()
.id(a.getId())
.name(a.getName())
.parent_id(a.getParent_id())
.article(a.getArticle() != null
? mapToArticleDTO(a.getArticle()) // 递归映射父级（可选）
: null)
.subArticle(a.getSubArticles() != null
? a.getSubArticles().stream()
.map(this::mapToArticleDTO)
.collect(Collectors.toSet())
: Collections.emptySet())
.build();
}
private Set<ArticleDTO> findSubArticles(Article article) {
Article parent = article.getArticle();
if (parent == null) return Collections.emptySet();
return parent.getSubArticles().stream()
.map(this::mapToArticleDTO)
.collect(Collectors.toSet());
}
}⚠️ 注意事项：
- 不要在 DTO 中直接暴露
Set<article></article>（如private Set<article> subArticle;</article>），应使用Set<articledto></articledto>避免序列化循环引用或懒加载异常； - 移除
@JsonProperty(access = JsonProperty.Access.WRITE_ONLY)对subArticles的限制（它阻止了 JSON 序列化输出），改用@JsonIgnore或@JsonInclude(JsonInclude.Include.NON_EMPTY)控制输出； - 若需深度嵌套（如树形结构），建议改用
@JsonManagedReference/@JsonBackReference或@JsonIgnore配合 DTO 层解耦，避免 Jackson 序列化时的无限递归； - 生产环境慎用
FetchType.EAGER，它易引发 N+1 查询或过度加载，事务 + 懒加载 + 显式初始化（如Hibernate.initialize()）才是可控方案。
总结：懒加载不是“失效”，而是“依赖事务”；只要确保关联属性的访问发生在 @Transactional 方法内，Spring 就会维持 Session 打开状态，使 subArticles 正确加载并序列化为非 null 结果。
