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
相关产品推荐
相关产品推荐

