本文介绍如何在 laravel 中根据用户传入的可选参数（如地区、城市、行业字段）动态构建 where 查询，实现灵活的多条件组合搜索，避免空值导致的 sql 错误。
本文介绍如何在 laravel 中根据用户传入的可选参数（如地区、城市、行业字段）动态构建 where 查询，实现灵活的多条件组合搜索，避免空值导致的 sql 错误。
在 Laravel 开发中，常需根据前端传入的零至多个搜索参数（如 $district、$city、$machine_field）对关联数据进行条件过滤。若直接使用固定 ->where() 链式调用，当某个参数为空时会导致查询逻辑错误（如匹配空字符串或引发 SQL 异常）。正确做法是将条件判断封装在闭包中，通过 where(function ($query) use (...)) 动态添加有效条件。
以下是优化后的控制器代码示例：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
$news_paper_machine_ads = newsPaperMachineAds::join('news_paper_district', 'news_paper_district.idnews_paper_district', '=', 'news_paper_machine_ads.news_paper_district_id')
->join('news_paper_city', 'news_paper_city.idnews_paper_city', '=', 'news_paper_machine_ads.news_paper_city_id')
->join('news_paper_machine_field', 'news_paper_machine_field.idnews_paper_machine_field', '=', 'news_paper_machine_ads.news_paper_machine_field_id')
->where(function ($query) use ($district, $city, $machine_field) {
if (!empty($district)) {
$query->where('district', 'LIKE', '%' . trim($district) . '%');
}
if (!empty($city)) {
$query->where('news_paper_city', 'LIKE', '%' . trim($city) . '%');
}
if (!empty($machine_field)) {
$query->where('machine_field', 'LIKE', '%' . trim($machine_field) . '%');
}
})
->get();✅ 关键要点说明：
- 使用
where()闭包确保所有条件在同一逻辑层级（AND 关系），避免因条件缺失导致意外全表扫描； - 对输入参数使用
!empty()判断（而非仅if($var)），防止'0'、'false'等非空但为 falsy 的字符串被误判跳过； - 建议配合
trim()清除首尾空格，提升健壮性； - 如需支持模糊搜索（如“北京”匹配“北京市”），当前
LIKE模式已满足；若需更精准匹配（如完全相等），可改为=运算符； - 后续可进一步封装为 Eloquent Scope 或 Service 类，提升复用性与可测试性。
该方案支持任意组合的参数传递（仅 district、district + city、全部三个字段等），真正实现“有参则查，无参则忽略”，是 Laravel 动态查询的标准实践。
