You need to enable JavaScript to run this app. Laravel开发API时如何为用户帖子接口添加点赞数、评论数及关联数据
优惠活动
大模型
产品
解决方案
定价
更多

Laravel开发API时如何为用户帖子接口添加点赞数、评论数及关联数据

原实现的核心问题

你当前接口返回重复帖子的原因主要有两个:

  • 关联条件写错:代码里的leftJoin('likes', 'likes.user_id', '=', 'users.id')没有把点赞表和帖子ID做匹配,只要是同一作者的所有点赞记录,不管对应哪条帖子,都会被直接拼到该作者发布的帖子行上,天然产生笛卡尔积重复。
  • 关联方式不合理:帖子和点赞、评论是一对多关系,直接把主表和明细表join,会因为1条帖子对应N条明细记录,把主表的行数放大N倍,出现大量重复的帖子条目。
推荐实现方案(Laravel Eloquent 生态最优解)

这种方式完全不会出现主表数据重复,还能避免N+1查询的性能损耗,是Laravel下处理关联数据的标准做法。

第一步:补全模型关联

在对应模型里提前定义好关联关系,后续查询可以直接复用:

  • App\Models\Post 模型内新增3个关联方法:
    • 帖子所属的发布用户:public function user() { return $this->belongsTo(User::class); }
    • 帖子下的全部评论:public function comments() { return $this->hasMany(Comment::class); }
    • 帖子收到的全部点赞:public function likes() { return $this->hasMany(Like::class); }
  • App\Models\Comment 模型内新增关联:public function user() { return $this->belongsTo(User::class); }(用于获取发布评论的用户信息)
  • App\Models\Like 模型内新增关联:public function user() { return $this->belongsTo(User::class); }(用于获取给帖子点赞的用户信息)

第二步:改写user_posts查询方法

利用Laravel内置的预加载、关联计数能力,一次性拉取所有需要的数据:

public function user_posts($id)
{
    // 先校验目标用户存在,避免无意义查询
    $user = User::findOrFail($id);
    
    return $user->posts()
        // 直接统计关联数量,返回的字段就是每个帖子的点赞数、评论数
        ->withCount([
            'likes as like_count',
            'comments as comment_count'
        ])
        // 预加载嵌套关联数据,避免循环内单独查库
        ->with([
            // 拉取帖子的点赞记录,同时嵌套加载点赞用户的基础信息
            'likes:id,user_id,post_id',
            'likes.user:id,name,avatar',
            // 拉取帖子的全部评论,同时嵌套加载评论作者的基础信息
            'comments:id,user_id,post_id,description,created_at',
            'comments.user:id,name,avatar'
        ])
        ->latest()
        ->get();
}
坚持使用DB Query Builder的适配方案

如果不想依赖Eloquent模型,可以通过子查询聚合的方式避免主表数据膨胀:

public function user_posts($id)
{
    // 预先聚合每个帖子的点赞统计
    $likeStats = DB::table('likes')
        ->select(
            'post_id',
            DB::raw('COUNT(id) as like_count'),
            DB::raw("JSON_ARRAYAGG(JSON_OBJECT('user_id', user_id, 'username', (select name from users where id = likes.user_id))) as like_users")
        )
        ->groupBy('post_id');
    
    // 预先聚合每个帖子的评论统计
    $commentStats = DB::table('comments')
        ->select(
            'post_id',
            DB::raw('COUNT(id) as comment_count')
        )
        ->groupBy('post_id');
    
    return DB::table('posts')
        // 关联预先聚合好的统计子查询,不会撑大主表行数
        ->leftJoinSub($likeStats, 'like_stats', 'posts.id', '=', 'like_stats.post_id')
        ->leftJoinSub($commentStats, 'comment_stats', 'posts.id', '=', 'comment_stats.post_id')
        ->where('posts.user_id', '=', $id)
        ->select(
            'posts.*',
            // 没收到点赞/没评论的帖子默认返回0,避免返回null值
            DB::raw('COALESCE(like_stats.like_count, 0) as like_count'),
            DB::raw('COALESCE(comment_stats.comment_count, 0) as comment_count'),
            DB::raw('COALESCE(like_stats.like_users, JSON_ARRAY()) as like_users')
        )
        ->get();
}
路由注意事项

当前你定义的路由是 /users/{id}/posts/like 对应like_show方法,要确认user_posts方法绑定的路由是Route::get('/users/{id}/posts', [PostController::class, 'user_posts']);,否则请求http://warm.test/api/users/6/posts会触发404错误。

改完之后的接口返回结构会嵌套所有关联数据,不会出现重复的帖子条目,单条帖子的返回示例结构为:

{
  "id": 6,
  "user_id": 6,
  "image": "https://lorempixel.com/xxx",
  "description": "帖子内容",
  "created_at": "2015-04-04 07:51:39",
  "like_count": 12,
  "comment_count": 5,
  "likes": [
    {"id":1, "user_id":3, "user": {"id":3, "name":"用户A", "avatar":"头像地址"}}
  ],
  "comments": [
    {"id":2, "user_id":4, "description":"评论内容", "user": {"id":4, "name":"用户B", "avatar":"头像地址"}}
  ]
}

内容的提问来源于stack exchange,提问作者alihancibooglu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 23:54:07