Laravel 8逗号分隔关联ID列如何实现一对多Eloquent关联查询

方案一：适配现有存储结构（无需改表，快速实现） #

该方案不需要修改你现有的数据库存储逻辑，同时解决了直接循环查询导致的N+1性能问题。

第一步：修改控制器代码 #

/**
 * 展示资源列表
 *
 * @return \Illuminate\Http\Response
 */
public function index()
{
    try {
        $pages = StatusPage::where('user_id', Auth::id())->get();

        // 注意：get()返回的是集合对象，永远不为空，需要用isEmpty判断是否有数据
        if ($pages->isEmpty()) {
            return response()->json([
                'success' => false,
                'message' => '未找到任何状态页'
            ], 404);
        }

        // 批量收集所有关联的监控ID，仅查询一次获取全部需要的监控数据
        $allMonitorIds = $pages->pluck('monitors')
            ->filter() // 过滤掉未关联监控的空值
            ->flatMap(fn($monitorStr) => explode(',', $monitorStr))
            ->unique()
            ->toArray();
        $monitorMap = Monitor::whereIn('id', $allMonitorIds)->get()->keyBy('id');

        // 给每个状态页挂载对应的关联监控数组
        $pages->each(function($page) use ($monitorMap) {
            $relatedMonitors = collect();
            if (!empty($page->monitors)) {
                $monitorIds = explode(',', $page->monitors);
                $relatedMonitors = $monitorMap->only($monitorIds)->values();
            }
            $page->related_monitors = $relatedMonitors;
        });

        return response()->json([
            'success' => true,
            'message' => '获取状态页列表成功',
            'pages' => $pages
        ], 200);

    } catch (\Exception $e) {
        return response()->json([
            'success' => false,
            'message' => $e->getMessage() // 建议仅返回错误信息，不要抛出完整异常对象
        ], 422);
    }
}

第二步（可选）：给StatusPage模型添加访问器 #

如果在其他场景也需要快速获取状态页关联的监控，可以在模型中定义访问器，无需重复写逻辑：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Database\Eloquent\Model;

class StatusPage extends Model
{
    use HasFactory, SoftDeletes;

    /**
     * 指示模型ID是否自增
     *
     * @var bool
     */
    public $incrementing = false;

    /**
     * 模型关联的表名
     *
     * @var string
     */
    protected $table = 'status_pages';

    // 定义关联监控的访问器
    public function getRelatedMonitorsAttribute()
    {
        if (empty($this->monitors)) {
            return collect();
        }
        $monitorIds = explode(',', $this->monitors);
        return Monitor::whereIn('id', $monitorIds)->get();
    }

    // 如果需要默认把关联监控加到模型输出中，取消下方注释即可
    // protected $appends = ['related_monitors'];
}

注意：直接使用访问器的场景下如果查询多条状态页会产生N+1查询问题，仅推荐单条状态页查询时使用，列表查询请使用控制器批量预加载的方案。

方案二：长期最优方案（改用多对多中间表） #

你当前的业务本质是StatusPage和Monitor的多对多关联，使用逗号分隔存储关联ID的方式不便于查询、没有索引性能差，更推荐使用中间表实现原生关联：

1. 新建中间表迁移文件：

Schema::create('monitor_status_page', function (Blueprint $table) {
    $table->foreignId('monitor_id')->constrained()->onDelete('cascade');
    $table->foreignId('status_page_id')->constrained()->onDelete('cascade');
    $table->primary(['monitor_id', 'status_page_id']); // 设置联合主键避免重复关联
});

2. 在StatusPage模型中定义多对多关联：

public function monitors()
{
    return $this->belongsToMany(Monitor::class);
}

3. 控制器中直接预加载关联即可：

$pages = StatusPage::where('user_id', Auth::id())->with('monitors')->get();

后续新增/删除关联直接用Laravel原生的attach、detach、sync等方法操作即可，维护成本更低、性能更好。

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