Laravel 9.1集成Breeze后users表慢查询导致页面加载缓慢求助

排查思路 #

• 先剥离框架层验证数据库原生性能：直接通过数据库客户端执行select * from users where id = 1 limit 1，如果原生执行耗时就达到秒级，问题出在数据库本身：
  • 执行show processlist（MySQL环境）查看是否有未提交的长事务持有users表的行锁/表锁，阻塞查询，找到异常会话直接kill即可。
  • 检查数据库服务器CPU、磁盘IO占用是否打满，资源耗尽时任何简单查询都会变慢。
  • 若users表存在频繁删改操作，执行OPTIMIZE TABLE users;整理表碎片，排除碎片过多导致的查询变慢。
• 如果原生SQL执行耗时在毫秒级，问题出在框架到数据库的连接链路或框架逻辑层：
  • 优先检查数据库连接配置，高频坑为.env中DB_HOST设置为localhost，该配置会让PDO优先尝试UNIX套接字连接，套接字路径配置错误或权限不足时，会等待连接超时后才回退到TCP连接，平白增加数秒耗时。
  • 检查是否开启了SQL日志、Debugbar等调试类服务，这类服务会在每条SQL执行时触发额外的写日志、收集数据操作，IO阻塞时会拖慢整体查询耗时。
  • 如果数据库服务部署在非本机，检查数据库是否开启了DNS反查，客户端连接时反查超时会导致连接建立阶段耗时数秒。
• 针对Breeze场景的定向排查：
  • 检查是否对User模型添加了自定义全局作用域，全局作用域中如果存在慢查询、远程接口请求等逻辑，会给原本简单的主键查询额外增加大量耗时，可执行User::withoutGlobalScopes()->find(1)验证是否为全局作用域导致的问题。
  • 检查User模型的$with属性，是否配置了非必要的预加载关联，若关联表未加对应索引，主键查询时触发的连表操作会大幅拖慢速度。
  • 检查认证相关中间件（如Authenticate、Inertia请求中间件）是否被自定义修改，是否存在其他慢逻辑被误统计为该条SQL的执行耗时。

按优先级排序的修复方案 #

1. 将.env中DB_HOST=localhost修改为DB_HOST=127.0.0.1，执行php artisan config:clear清除配置缓存后刷新页面验证，该问题占同类症状的80%以上。
2. 直连数据库清理异常长事务，释放锁资源。
3. 生产环境将.env中APP_DEBUG设置为false，执行php artisan optimize缓存框架引导文件、路由、配置，排除调试模式带来的额外性能损耗。
4. 若数据库开启了DNS反查，在数据库配置中添加skip-name-resolve参数关闭反查，重启数据库服务生效。
5. 移除User模型中非必要的预加载关联、慢查询全局作用域，给关联表添加对应外键索引。

内容的提问来源于stack exchange，提问作者Bonci Marco