Laravel 中使用 whereRaw 实现 MySQL 全文搜索时，若未正确括号分组逻辑运算符（如 AND/OR），会导致非全文字段（如 type、status）的筛选失效，返回不符合业务条件的冗余结果。
laravel 中使用 `whereraw` 实现 mysql 全文搜索时，若未正确括号分组逻辑运算符（如 `and`/`or`），会导致非全文字段（如 `type`、`status`）的筛选失效，返回不符合业务条件的冗余结果。
在 Laravel + MySQL 的全文搜索实践中，一个常见却隐蔽的问题是：当 WHERE 条件同时包含普通字段过滤（如 type = 'image'、status = 1）和多个 MATCH ... AGAINST 全文匹配时，因 SQL 运算符优先级缺失，OR 会意外“突破”前面的 AND 约束，使整个条件逻辑失效。
例如，原始查询：
->whereRaw(
"products.type = ?
AND MATCH(keywords.keyword) AGAINST(? IN BOOLEAN MODE)
OR MATCH(products.description) AGAINST(? IN BOOLEAN MODE)
OR MATCH(products.description_en) AGAINST(? IN BOOLEAN MODE)",
['image', $searchTerms, $searchTerms, $searchTerms]
)其实际执行的 SQL 等价于：
WHERE (products.type = 'image' AND MATCH(...) AGAINST(...)) OR MATCH(...) AGAINST(...) OR MATCH(...) AGAINST(...)
这意味着：只要任意一个 MATCH 成功，即使 type ≠ 'image' 或 status ≠ 1，该记录也会被返回——这正是问题根源。
✅ 正确做法是显式用括号包裹所有全文搜索分支，确保 AND 作用于整个全文匹配组：
->whereRaw(
"products.type = ?
AND (
MATCH(keywords.keyword) AGAINST(? IN BOOLEAN MODE)
OR MATCH(products.description) AGAINST(? IN BOOLEAN MODE)
OR MATCH(products.description_en) AGAINST(? IN BOOLEAN MODE)
)",
['image', $searchTerms, $searchTerms, $searchTerms]
)这样 SQL 解析为：
WHERE products.type = 'image' AND (MATCH(...) OR MATCH(...) OR MATCH(...))
✅ 同时，请确认 scopeAccepted() 已正确定义且被调用（如示例中已链式调用 ->accepted()），并注意：
- 所有参与 MATCH 的字段必须已建立 FULLTEXT 索引（如 ALTER TABLE keywords ADD FULLTEXT(keyword);）；
- GROUP BY 字段需覆盖 SELECT 中所有非聚合列（当前写法存在风险，建议改用 SELECT * 或严格对齐 GROUP BY products.id 即可，避免重复 GROUP BY 多个字段引发兼容性问题）；
- 若使用 MySQL 8.0+，可考虑 NATURAL LANGUAGE MODE 或更灵活的 BOOLEAN MODE 语法（如 +laravel -php）提升精度。
总结：全文搜索不是“黑盒”，它仍遵循标准 SQL 逻辑优先级。任何混合 AND/OR 的 whereRaw 都应主动加括号明确语义——这是保障业务条件不被绕过的关键防线。
