如何使用Laravel Eloquent查询自定义Pivot中间表的关联关系

你要实现的筛选需求有两种常用的可落地方案：

方案1：直接JOIN频道表（性能最优，无需修改现有模型） #

因为中间表user_preference已经存储了channel_id字段，你可以直接在多对多查询中关联channels表添加筛选条件：

$preferences = $user->preferences()
     ->wherePivot('enabled', true)
     // 关联中间表对应的频道表
     ->join('channels', 'user_preference.channel_id', '=', 'channels.id')
     // 此处添加你需要的频道筛选条件，以下为示例
     ->where('channels.status', 1)
     ->where('channels.type', 'sms')
     // 指定仅返回preference表字段，避免字段冲突
     ->select('preferences.*')
     ->get();

方案2：通过中间表关联查询（ORM风格，适合复杂逻辑） #

如果需要大量复用Pivot模型的channel关联逻辑，可以补充少量关联定义后用ORM原生的whereHas实现：

第一步：补充关联定义 #

1. 给UserNotificationPreference模型添加preference关联：

class UserNotificationPreference extends Pivot
{
    // 原有代码保持不变
    public function preference(): BelongsTo
    {
        return $this->belongsTo(Preference::class);
    }
}

2. 给User模型添加到中间表的一对多关联：

class User extends Authenticatable
{
    // 原有代码保持不变
    public function notificationPreferences(): HasMany
    {
        return $this->hasMany(UserNotificationPreference::class);
    }
}

第二步：执行查询 #

$preferences = $user->notificationPreferences()
    ->where('enabled', true)
    // 直接使用Pivot模型上定义的channel关联做筛选
    ->whereHas('channel', function (\Illuminate\Database\Eloquent\Builder $query) {
        // 此处添加频道筛选条件
        $query->where('name', '企业微信');
    })
    ->with('preference')
    ->get()
    ->pluck('preference')
    // 去重避免同一个偏好设置匹配多个频道的场景
    ->unique('id');

现有代码注意事项 #

你当前提供的模型定义存在两处笔误，建议先修正避免关联异常：

• User模型的preferences方法中，withPivot([enabled, channel_id])缺少字符串引号，应为withPivot(['enabled', 'channel_id'])
• Preference模型的users关联第一个参数错误，应为belongsToMany(User::class, ...)，而非Preference::class

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