Laravel 8 中高效查询用户好友列表并支持姓名/邮箱模糊搜索-php教程-PHP中文网

Laravel 8 中高效查询用户好友列表并支持姓名/邮箱模糊搜索

本文详解如何在 Laravel 8 中精准检索「当前用户的好友」且仅返回 is_individual = 1 的个体用户，通过模型关联与优化查询避免 N+1 和冗余数据库操作。

本文详解如何在 laravel 8 中精准检索「当前用户的好友」且仅返回 `is_individual = 1` 的个体用户，通过模型关联与优化查询避免 n+1 和冗余数据库操作。

在 Laravel 8 开发中，实现「搜索好友列表中符合条件的个体用户」需兼顾准确性、性能与可维护性。原始方案存在明显缺陷：

getIndividulsFriendsIds() 多次查询（两次 pluck + 一次 whereIn）导致冗余 SQL；
array_merge + array_unique 在 PHP 层去重，未利用数据库索引优势；
with('friendList') 在搜索场景下无实际意义（无需预加载关系数据），反而增加内存开销。

✅ 推荐方案：使用 whereExists 实现高效关联过滤

首先，在 User 模型中定义双向好友关系（更符合业务语义）：

// app/Models/User.php
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // 当前用户作为「发起方」的好友记录（user_id = 当前用户）
    public function friendsAsSender()
    {
        return $this->hasMany(FriendList::class, 'user_id', 'id');
    }

    // 当前用户作为「接收方」的好友记录（to_id = 当前用户）
    public function friendsAsReceiver()
    {
        return $this->hasMany(FriendList::class, 'to_id', 'id');
    }
}

然后在控制器中编写单次高效查询：

Laravel

避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

// 在控制器方法中
$user_id = Auth::id();

$searchTerm = $request->search ?? '';

$users = User::where('is_individual', 1)
    ->where(function ($query) use ($searchTerm) {
        $query->where('name', 'like', "%{$searchTerm}%")
              ->orWhere('email', 'like', "%{$searchTerm}%");
    })
    ->whereExists(function ($query) use ($user_id) {
        // 匹配：当前用户是好友关系中的发起方（user_id）或接收方（to_id）
        $query->from('friend_lists')
              ->whereRaw('friend_lists.user_id = users.id AND friend_lists.to_id = ?', [$user_id])
              ->orWhereRaw('friend_lists.to_id = users.id AND friend_lists.user_id = ?', [$user_id]);
    })
    ->select('id', 'name', 'email', 'is_individual') // 显式指定字段，提升性能
    ->get();

? 关键优化说明：

✅ 零中间数组操作：全程在数据库内完成关联判断，避免 PHP 层合并/去重；
✅ 精准索引利用：确保 friend_lists(user_id, to_id) 和 friend_lists(to_id, user_id) 存在复合索引（如 INDEX (user_id, to_id) 和 INDEX (to_id, user_id)）；
✅ 安全防空搜索：添加 $request->search ?? '' 避免 null 导致 SQL 错误；
✅ 字段精简：select() 明确指定返回字段，减少网络传输与内存占用。

⚠️ 注意事项：