Laravel Telescope调试_Telescope查看请求和查询详情【详解】-php教程-PHP中文网

telescope 页面为空是因为 watcher 未启用、环境非 local、配置被跳过或迁移未执行；需检查 config/telescope.php 中 requestwatcher 和 querywatcher 是否为 true，并确认已运行 php artisan migrate。

laravel telescope调试_telescope查看请求和查询详情【详解】

Telescope 路由能访问、界面能打开，但看不到请求或 SQL 查询？大概率是 watcher 没开、环境没对、或配置被跳过。

Telescope 不是“装完就自动全量记录”，它默认只启用部分 watcher，且强依赖运行时环境判断。常见原因有：

APP_ENV 不是 local（比如设成了 dev 或 staging），哪怕 APP_DEBUG=true 也无效
config/telescope.php 中对应 watcher 的 enabled 是 false，例如 'Laravel\Telescope\Watchers\RequestWatcher' => false 或 'Laravel\Telescope\Watchers\QueryWatcher' => false
用了 Laravel 11+，但 App\Providers\TelescopeServiceProvider 没在 config/app.php 的 providers 数组里显式注册（Laravel 11 默认不自动发现）
执行过 php artisan telescope:install 却漏掉 php artisan migrate，导致数据表缺失，写入失败静默丢弃

别只看界面，直接查配置和日志行为：

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

打开 config/telescope.php，搜索 RequestWatcher 和 QueryWatcher，确保它们的值是 true
在代码里加一行 Telescope::recordMessage('test request hit', 'debug');，刷新页面后去 /telescope → “Messages” 标签页找，能看见说明 Telescope 基础链路通了
手动触发一个带查询的路由（比如 User::first()），然后立刻执行 php artisan tinker 并运行：DB::enableQueryLog(); User::first(); dd(DB::getQueryLog()); —— 如果这个能打出 SQL，但 Telescope 里没记录，基本锁定是 QueryWatcher 未启用或被 ignore 规则过滤
QueryWatcher 默认会忽略 SHOW TABLES、PRAGMA 等元数据查询，这是正常行为，不是 bug

这其实是 Telescope 的设计限制：它只在 QueryWatcher 捕获到查询时才记录绑定参数，而「请求详情页里的 Queries 子 tab」只是关联展示，不重新解析。所以关键点是：

必须确保 QueryWatcher 已启用，且没被 ignore 配置拦截（比如设置了 'prefixes' => ['test_'] 却查的是 users 表）
绑定参数只在预处理语句（DB::table()->where(...)->get() 这类）中生效；原生 DB::select("SELECT * FROM users WHERE id = $id") 是字符串拼接，Telescope 记录的就是拼完的完整 SQL，没有“绑定”概念
如果用了读写分离，且查询走的是从库连接，需确认 QueryWatcher 是否监听了该连接名（默认只监听 default）
某些 ORM 封装（如 Eloquent 的 toSql()）不会触发 QueryWatcher，因为它没真正执行

不是“慢一点”，而是可能直接拖垮服务：

每条 HTTP 请求都会序列化整个 Request 和 Response 对象（含 body、headers、session），内存暴涨
每个 SQL 查询都记录完整绑定参数 + 执行时间 + 堆栈，高频写入会导致数据库 I/O 瓶颈，尤其是用 MySQL 时容易锁表
Telescope 的 telescope_entries 表没有复合索引优化，默认只有 created_at 单字段索引，查历史数据越来越卡
TELESCOPE_ENABLED=false 不可靠——只要 APP_ENV=local，Telescope 就会绕过这个开关强制加载路由和 watcher

最保险的做法：生产环境的 .env 里死守 APP_ENV=production，并且删掉 App\Providers\TelescopeServiceProvider 在 register() 中的任何条件注册逻辑。