评论嵌套异常：子评论mentions为空且需限制两级结构

问题1：子评论mentions字段返回null #

原因 #

1. 子评论的childComments是懒加载（FetchType.LAZY），查询根评论时未关联加载子评论的mentionUsers，脱离持久化上下文后无法获取数据
2. MapStruct默认未配置UserEntity到字符串的转换逻辑，无法将mentionUsers列表映射为mentions列表

解决步骤 #

1. 关联加载子评论及其提及用户

在CommentRepository中添加带实体图的查询方法，确保一次性加载所有需要的数据，避免懒加载问题：

public interface CommentRepository extends JpaRepository<CommentEntity, Long>, JpaSpecificationExecutor<CommentEntity> {
    @EntityGraph(attributePaths = {"childComments", "childComments.mentionUsers"})
    Page<CommentEntity> findAll(Specification<CommentEntity> spec, Pageable pageable);
}

2. 完善MapStruct的类型转换

在CommentMapper中添加UserEntity到字符串的转换方法，确保mentionUsers能正确映射为mentions：

@Mapper(componentModel = "spring")
public interface CommentMapper {
    // 根评论映射方法（包含子评论）
    @Mapping(source = "comment.mentionUsers", target = "mentions")
    @Mapping(source = "comment.childComments", target = "childComments")
    CommentListResponse.CommentItem toRootCommentItem(CommentEntity comment, boolean includeDeletedField);

    // 转换UserEntity为提及标识（根据实际业务调整，比如返回ID或用户名）
    default String userToMentionId(UserEntity user) {
        return user.getId().toString();
    }
}

问题2：子评论不应显示childComments字段 #

原因 #

当前映射逻辑会递归生成子评论的childComments（即使为空列表），需要明确在映射子评论时忽略该字段

解决步骤 #

1. 为根/子评论创建差异化映射方法

在CommentMapper中新增子评论专属映射方法，忽略childComments，并指定集合映射时使用该方法：

@Mapper(componentModel = "spring")
public interface CommentMapper {
    // 根评论映射方法（包含子评论）
    @Mapping(source = "comment.mentionUsers", target = "mentions")
    @Mapping(source = "comment.childComments", target = "childComments")
    CommentListResponse.CommentItem toRootCommentItem(CommentEntity comment, boolean includeDeletedField);

    // 子评论映射方法（忽略childComments）
    @Mapping(source = "comment.mentionUsers", target = "mentions")
    @Mapping(target = "childComments", ignore = true)
    CommentListResponse.CommentItem toChildCommentItem(CommentEntity comment, boolean includeDeletedField);

    // 指定子评论集合映射使用子评论专属方法
    @IterableMapping(qualifiedByName = "mapChildComment")
    List<CommentListResponse.CommentItem> mapChildComments(List<CommentEntity> comments, boolean includeDeletedField);

    @Named("mapChildComment")
    default CommentListResponse.CommentItem mapChildComment(CommentEntity comment, boolean includeDeletedField) {
        return toChildCommentItem(comment, includeDeletedField);
    }

    default String userToMentionId(UserEntity user) {
        return user.getId().toString();
    }
}

2. 修改Service层的映射调用

将原来的通用映射方法替换为根评论专属方法：

List<CommentListResponse.CommentItem> comments = page.stream()
    .filter(comment -> comment.getParentCommentId() == null)
    .map(comment -> commentMapper.toRootCommentItem(comment, deleted != null))
    .toList();

3. 可选：添加JSON序列化控制

在CommentItem的childComments字段上添加注解，确保null值不被序列化：

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public static class CommentItem {
    // 其他字段...
    @JsonInclude(JsonInclude.Include.NON_NULL)
    private List<CommentItem> childComments;
    // 其他字段...
}

修改后预期JSON输出 #

{
    "id": 1,
    "body": "test root comment",
    "mentions": ["user-1"],
    "parentCommentId": null,
    "childComments": [
        {
            "id": 3,
            "body": "test child comment",
            "mentions": ["user-2"],
            "parentCommentId": 1
        }
    ]
}

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