多条件搜索出错主因是空值未判空导致SQL条件误生效；应使用filled()判空并配合when()构建查询，日期范围需用startOfDay()/endOfDay()避免漏数据，模糊/精确/范围匹配宜用策略模式而非硬编码。
多条件搜索时 where() 链式调用总出错？
根本原因不是语法错，而是 where() 在空值或未提交字段上直接拼接，导致 SQL 条件意外生效。比如用户没填“状态”，但代码仍执行 ->where('status', $request->status)，查出来的就是 status = NULL 的记录，而不是“不限状态”。
实操建议：
- 对每个搜索字段做显式判空：用
filled()判非空字符串/数字，用isset()或array_key_exists()判键存在，避免empty()（会把 '0'、'false' 当空） - 用
when()代替手动 if + where：它只在条件为真时才执行闭包里的查询构建，天然规避空值污染 - 示例：
$query = Product::query(); $query->when($request->filled('name'), function ($q) use ($request) { return $q->where('name', 'like', "%{$request->name}%"); }); $query->when($request->filled('category_id'), function ($q) use ($request) { return $q->where('category_id', $request->category_id); });
日期范围搜索怎么写才不漏数据？
常见错误是直接用 whereBetween('created_at', [$start, $end])，但数据库里 created_at 是 datetime 类型，而用户输入的日期（如 '2024-05-01'）没带时间，默认变成 '2024-05-01 00:00:00'，结果当天 10:30 的记录就被漏掉了。
实操建议：
- 把起始日期转成当天零点，结束日期转成次日零点，再用
where()+>=和替代 <code>whereBetween - 用 Laravel 内置的
Carbon处理更稳：用Carbon::parse($date)->startOfDay()和Carbon::parse($date)->endOfDay() - 注意时区：确保
config/app.php的'timezone'和数据库时区一致，否则startOfDay()算出来的时间可能偏移
搜索字段要支持模糊、精确、范围三种匹配方式？
硬编码多个 when() 分支容易失控，尤其当字段多、匹配逻辑杂（比如 price 要支持 >、
实操建议：
- 把搜索规则抽成配置数组，每个字段定义
type（'like' / 'exact' / 'gte' / 'range'）和可选的column映射 - 写一个通用解析方法，遍历请求参数，按 type 分发处理，避免重复 if 块
- 对 range 类型（如价格区间），约定参数名带
_from和_to后缀，比如price_from和price_to，比传数组更易调试、更兼容 GET 请求 - 别在查询里用
orWhere()混合不同字段——它会破坏 AND 优先级，必须用where(function () {})包裹才能保证逻辑正确
搜索性能突然变慢，是不是加了索引就完事？
加了单列索引不一定有效。比如 where status = ? and category_id = ? and name like ?，三个字段单独建索引，MySQL 通常只用其中一个；而 like '%xxx' 开头的查询，哪怕有索引也用不上。
实操建议：
- 复合索引顺序很重要：把等值查询字段放前面（如
status,category_id），like字段放最后，且仅限前缀匹配（name like 'xxx%'） - 对高频模糊搜字段，考虑用 MySQL 5.7+ 的全文索引，或接入 Elasticsearch —— 但别一上来就上重方案，先用
EXPLAIN看实际执行计划 - 分页深翻（
offset很大）时，用游标分页（where id > ? limit 20）替代skip/take，不然搜索结果一多，count()和offset都拖垮响应
多条件搜索真正的难点不在拼 SQL，而在判断哪些条件该进查询、哪些该进内存过滤、哪些压根不该暴露给用户。边界情况（比如空字符串、负数价格、非法日期）比主流程更容易引发线上问题。
