本文介绍如何在 Laravel Eloquent 中高效实现「按城市 ID 筛选 + 街道名模糊匹配」的查询，避免重复数据与性能瓶颈，通过 distinct()、join() 和合理索引优化，兼顾准确性与响应速度（毫秒级）。
本文介绍如何在 laravel eloquent 中高效实现「按城市 id 筛选 + 街道名模糊匹配」的查询，避免重复数据与性能瓶颈，通过 `distinct()`、`join()` 和合理索引优化，兼顾准确性与响应速度（毫秒级）。
在构建地址搜索功能时，常见需求是：给定城市 ID 和街道关键词（如 %rue%），返回所有匹配的唯一街道名及其所属城市名称。直接从 Residence 表出发（whereHas('street')）会导致结果重复（一条街道对应多套住宅），而先查街道再逐条关联住宅则引发 N+1 查询和全表扫描，2000 万级 residences 表下耗时高达 15 秒——这显然不可接受。
最优解是绕过模型关系链，使用原生 JOIN 一次性关联三张表，并利用数据库层去重与筛选。以下是推荐实现（Laravel 10+，兼容 MySQL/PostgreSQL）：
use App\Models\Addresses\fr\FrStreet;
use App\Models\Addresses\fr\FrCity;
use App\Models\Addresses\fr\FrResidence;
public function searchStreets(Request $request)
{
$cityId = $request->input('city_id');
$nameLike = '%' . $request->input('name', '') . '%';
$limit = $request->input('limit', 10);
// 关键：使用 join 避免 N+1，select distinct 防止重复街道
$results = FrStreet::select('streets.id', 'streets.name', 'cities.name as city_name', 'cities.id as city_id')
->distinct() // 确保每条街道只出现一次
->join('residences', 'streets.id', '=', 'residences.street_id')
->join('cities', 'residences.city_id', '=', 'cities.id')
->where('residences.city_id', $cityId)
->where('streets.name', 'LIKE', $nameLike)
->limit($limit)
->get();
return $results->map(function ($item) use ($request) {
return $this->createStreetResult($request->country, [
'name' => $item->name,
'street_id' => $item->id,
'cityName' => $item->city_name,
'cityId' => $item->city_id,
]);
});
}
✅ 为什么这个方案更快？
- ✅ 单次查询完成全部逻辑：
JOIN在数据库引擎内完成关联，避免 PHP 层循环和多次查询； - ✅
DISTINCT在 SQL 层去重：比 PHPcollect()->unique('id')更早过滤，减少传输与内存开销； - ✅ WHERE 条件下推至最底层：
city_id和street.name LIKE均作用于 JOIN 后结果集，充分利用索引； - ✅ 无模型懒加载开销：不调用
$street->city或$residence->city，避免隐式查询。
⚠️ 关键注意事项：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
-
必须为高频查询字段添加数据库索引：
-- 加速 LIKE 左模糊（%xxx）效果有限，但前缀匹配（xxx%）可走索引 ALTER TABLE streets ADD INDEX idx_streets_name (name); ALTER TABLE residences ADD INDEX idx_residences_city_street (city_id, street_id);
- 若需支持
'%rue%'（全模糊），建议搭配全文索引（MySQLFULLTEXT）或引入 Elasticsearch； - 避免在
where()中拼接用户输入（已用参数绑定防御 SQL 注入）； - 如需分页，改用
paginate()而非limit()，并注意distinct与ORDER BY的兼容性（必要时用子查询）。
? 进阶提示：若业务允许放宽“严格城市归属”语义（即某街道在该城市存在至少一套住宅即可），此方案完全满足；若需返回该街道在目标城市的所有住宅数或最小门牌号等聚合信息，可在 SELECT 中加入 COUNT(*) as residence_count 或 MIN(residences.number)，进一步提升信息密度。
综上，抛弃“关系驱动”的思维惯性，拥抱 JOIN + DISTINCT + 索引 组合拳，是处理大规模一对多搜索场景的 Laravel 最佳实践。
