本文探讨了在 Laravel 9 中基于 Spatie\QueryBuilder\QueryBuilder 生成查询 SQL 时，如何解决同一字段无法同时支持模糊与精确检索的问题。现有方案限制每个字段只能使用一种过滤器，为此文章提出验证字段类型为数组，并根据元素数量判断逻辑：若数量大于 1 则执行精确检索，否则执行模糊检索，从而实现了单个字段灵活支持两种检索方式。
针对Laravel 9中复用Spatie QueryBuilder构建导出功能时遇到的序列化报错问题，文章介绍了在异步队列中将Request对象转换为数组传递，进而在队列内部重新构造Request对象的解决方案。经过对比打印，转换前后的请求数据完全一致，最终成功复用了查询构建逻辑，实现了符合预期的功能。
👨💻 个人品牌
王世强｜PHP / Go 技术顾问
15+ 年 Web 后端开发经验，专注于系统维护、架构优化、性能调优及 Linux 运维。
持续运营技术博客 10+ 年，累计发布 1000+ 篇原创技术文章。
为创业团队、中小企业及独立开发者提供长期技术支持与远程合作服务。
.env (14) add (16) AI 翻译 (30) Apache (13) Array (19) A Tour of Go (67) Cache (13) CentOS (23) ChatGPT (20) ChatGPT Plus (15) chrome (19) Cloudflare (33) Codex (22) composer (42) composer.json (22) composer install (13) composer update (14) console (16) Container (25) curl (16) delete (31) Docker (32) Dockerfile (15) EdgeOne (33) environment variable (19) error (24) file (15) filter (20) Git (27) GitHub (23) Gitlab (15) GLM-5.2 (26) Go (61) go-tour-i18n (14) Google AdSense (29) Go 语言 (24) GraphQL (24) GraphQL API (14) Gutenberg (34) http (21) https (22) Interface (19) Jquery (13) json (24) Laravel (37) Laravel 6 (55) Laravel 9 (25) Lighthouse (17) Lighthouse 5 (14) Linux (22) Migrate (13) Module (17) MySQL (78) MySQL 5.7 (22) Nginx (63) normalize.css (28) OKX (15) OneinStack (21) PHP (67) php-fpm (19) php.ini (24) PHP 7.1.12 (22) PHP 7.4 (26) phpmyadmin (15) PhpStorm (24) Polylang (57) postman (18) Query (17) queue (16) Rancher (24) Redis (50) response (13) RESTful (27) RESTful API (23) Shopify (19) SlyTranslate (20) SQL (24) String (14) TortoiseGit (14) Twenty Twenty-Five (20) Ubuntu (40) update (20) VPN (17) W3 Total Cache (37) Windows 10 (46) WireGuard (28) WordPress (131) WordPress 多语言 (13) WPCode (23) Wstunnel (15) Yii (40) Yii 2 (70) Yii 2.0 (51) ZgoCloud (13) 多语言翻译 (35) 技术博客 (15) 故障排查 (15) 数据库迁移 (16) 浏览器 (14) 阿里云 (19)
