Laravel关联查询加载缓慢问题排查与优化求助

核心问题 #

1. N+1查询灾难：在IndustrialEstates资源中使用$this->customers()->with('customeruser')->get()，意味着每个分页的SetIndustrialEstate实例都会单独执行一次customers关联查询，再嵌套执行每个customer的customeruser查询，最终产生大量重复SQL请求，直接拖慢整体响应速度。
2. 无限制加载海量数据：直接调用get()会一次性拉取产业园区下所有关联的Customer和CustomerUser数据，当单园区关联上千条客户数据时，单次请求的数据量会异常庞大，导致数据库IO、内存开销剧增。
3. 缺少关联索引：如果customers表的set_industrial_estate_id字段、customer_users表的customer_id字段未建立索引，数据库会进行全表扫描，在5万级数据量的表中，这类扫描会极其耗时。

优化步骤 #

1. 修正预加载逻辑，根除N+1查询 #

修改SetIndustrialEstate的查询代码，提前预加载嵌套关联，避免在资源中延迟触发查询：

return IndustrialEstateResource::collection(
    SetIndustrialEstate::orderBy('id', 'DESC')
        ->with(['customers.customeruser']) // 预加载customers及其关联的customeruser
        ->paginate(25)
);

2. 对关联数据分页，控制单请求数据量 #

若业务无需返回园区下所有客户数据，在资源中对customers进行分页处理：

// IndustrialEstates资源文件中
'customers' => CustomerResource::collection(
    $this->customers()->with('customeruser')->paginate(10) // 按需设置每页条数
),

若必须返回全部数据，优先确保关联字段有索引，同时评估前端渲染大量数据的可行性（前端渲染过载也会导致页面卡顿）。

3. 添加数据库索引，加速关联查询 #

为关联字段创建索引，避免数据库全表扫描：

-- 给customers表的关联字段加索引
CREATE INDEX idx_customers_set_industrial_estate_id ON customers(set_industrial_estate_id);

-- 给customer_users表的关联字段加索引
CREATE INDEX idx_customer_users_customer_id ON customer_users(customer_id);

4. 优化资源关联调用逻辑 #

资源中直接使用预加载的关联属性，而非重新执行查询：

// IndustrialEstates资源文件中（基于预加载的关联）
'customers' => CustomerResource::collection($this->customers),

然后在CustomerResource中处理customeruser的返回：

// CustomerResource.php文件中
'customeruser' => CustomerUserResource::collection($this->customeruser),

额外排查建议 #

• 开启Laravel查询日志，查看实际执行的SQL语句，确认是否存在不必要的全表扫描：

DB::enableQueryLog();
// 执行你的查询逻辑
dd(DB::getQueryLog());

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