Spring Boot JPA自关联查询子记录返回Null问题求助

核心问题梳理 #

开发Rest API时，查询文章的子记录始终返回null，结合代码和数据库关联记录（数据库中存在父文章与对应子文章的关联数据，parent_id字段关联正确），问题出在以下几个方面：

问题点与修正方案 #

1. 实体类关联映射配置缺失 #

实体类Article的父子关联未指定数据库字段映射，导致JPA无法识别关联关系：

• @ManyToOne字段article未用@JoinColumn关联数据库的parent_id字段，JPA无法正确匹配父实体
• @OneToMany的subArticles集合因父关联映射错误，无法加载子记录

修正后的Article实体类：

@Entity
@JsonIgnoreProperties({"hibernate_lazy_initializer", "handler"})
@EqualsAndHashCode(onlyExplicitlyIncluded = true)
@JsonNaming(PropertyNamingStrategies.SnakeCaseStrategy.class)
public class Article {
    @Id
    @Getter
    @Setter
    @EqualsAndHashCode.Include
    private Long id;

    @Getter
    @Setter
    @EqualsAndHashCode.Include
    private Long parent_id;

    @Getter
    @Setter 
    @EqualsAndHashCode.Include
    private String name;

    // 添加@JoinColumn指定关联字段
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "parent_id")
    @Getter
    @Setter
    private Article article;

    @OneToMany(fetch = FetchType.LAZY, mappedBy = "article")
    @Setter
    private Set<Article> subArticles;

    @JsonIgnore
    public Set<Article> subArticles() {
        return subArticles;
    }
}

2. 懒加载脱离持久化上下文 #

默认的findById方法不会主动加载懒加载关联集合，控制器中访问subArticles()时，已脱离JPA持久化上下文，导致集合无法初始化。

修正方案：自定义查询主动加载关联集合
修改ArticleRepository，添加带FETCH JOIN的查询方法：

@Repository
public interface ArticleRepository extends JpaRepository<Article, Long>{
    // 主动加载子集合
    @Query("SELECT a FROM Article a LEFT JOIN FETCH a.subArticles WHERE a.id = :id")
    Optional<Article> findByIdWithSubArticles(@Param("id") Long id);

    // 根据父ID查询子文章（用于获取兄弟节点）
    @Query("SELECT a FROM Article a WHERE a.parent_id = :parentId")
    Set<Article> findByParentId(@Param("parentId") Long parentId);
}

3. DTO转换逻辑缺失与字段不匹配 #

• ArticleDTO中的subArticle字段与实体类subArticles名称不一致
• mapToArticleDTO转换函数未设置子集合字段，导致即使实体加载了子记录，DTO也不会包含该数据
• DTO中直接引用实体类Article，易引发懒加载异常和循环序列化问题

修正后的ArticleDTO：

@Data
@Builder
@JsonNaming(PropertyNamingStrategies.SnakeCaseStrategy.class)
public class ArticleDTO {
    private Long id;
    private String name;
    private Long parent_id;
    private ArticleDTO article; // 用DTO替代实体类，避免序列化问题
    private Set<ArticleDTO> subArticle;
}

修正后的控制器转换逻辑：

@RestController
@RequestMapping("/api/v1/article")
public class ArticleController {

    @Autowired
    private ArticleRepository articleRepository;

    @GetMapping("/{id}")
    public ResponseEntity<ArticleDTO> getArticle(@PathVariable("id") Long id) {
        return articleRepository.findByIdWithSubArticles(id)
                .map(mapToArticleDTO)
                .map(ResponseEntity::ok)
                .orElse(ResponseEntity.notFound().build());
    }

    @GetMapping("/{id}/siblings")
    public ResponseEntity<Set<ArticleDTO>> getSiblings(@PathVariable("id") Long id) {
        return articleRepository.findById(id)
                .map(article -> articleRepository.findByParentId(article.getParent_id()))
                .map(siblings -> siblings.stream()
                        .map(a -> ArticleDTO.builder().id(a.getId()).name(a.getName()).build())
                        .collect(Collectors.toSet()))
                .map(ResponseEntity::ok)
                .orElse(ResponseEntity.notFound().build());
    }

    // 补充子集合的DTO转换
    private Function<Article, ArticleDTO> mapToArticleDTO = a -> ArticleDTO.builder()
            .id(a.getId())
            .name(a.getName())
            .parent_id(a.getParent_id())
            .subArticle(a.getSubArticles().stream()
                        .map(sub -> ArticleDTO.builder().id(sub.getId()).name(sub.getName()).build())
                        .collect(Collectors.toSet()))
            .build();
}

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