telescope面板看不到队列/日志/事件数据,是因为jobwatcher、logwatcher、eventwatcher默认禁用,需在config/telescope.php中显式启用并配置levels、with_bindings等参数,同时确保环境为local、路由注册且权限正确。

Telescope 不是“开了就能看到所有东西”的黑盒工具,它默认只采集部分行为,且很多监控项在安装后处于关闭状态。必须手动开启对应 watcher 并确认环境、路由、权限全部就位,否则面板里永远只有空荡荡的 Requests 列表。
为什么 Telescope 面板看不到队列/日志/事件数据?
默认配置下,JobWatcher、LogWatcher、EventWatcher 这些监听器都是禁用的——它们不会自动记录任何数据,哪怕你代码里写了 dispatch() 或 Log::info()。
- 检查
config/telescope.php中的watchers数组,确保对应类的值为true,例如:'Laravel\Telescope\Watchers\JobWatcher' => true -
LogWatcher默认只捕获error和critical级别日志;如需info,要显式加'levels' => ['debug', 'info', 'notice', 'warning', 'error', 'critical'] -
EventWatcher不会捕获dispatchSync()调用,也不会记录未真正触发的事件(比如条件判断没走通) - 运行
php artisan route:list | grep telescope,没输出说明路由根本没注册——大概率是APP_ENV不是local,或TelescopeServiceProvider没被加载(Laravel 11+ 需手动加到config/app.php的providers里)
如何让 SQL 查询显示绑定参数和调用堆栈?
默认的 QueryWatcher 只显示原始 SQL 和执行时间,不带参数、不带哪行代码发起的查询,这对排查 N+1 或参数污染毫无帮助。
- 在
config/telescope.php的watchers配置中,找到QueryWatcher对应项,加上'with_bindings' => true - 确保
'slow' => 100这类阈值设得合理(单位毫秒),否则慢查询告警不会触发 - 如果堆栈缺失,检查是否启用了
DB::enableQueryLog()—— Telescope 不依赖它,但某些自定义封装可能干扰上下文捕获 - 注意:开启
with_bindings后,敏感字段(如密码)若未在Telescope::hideRequestParameters()中声明,可能被完整记录
请求体或响应内容被截断怎么办?
默认 RequestWatcher 的 size_limit 是 64 KB,上传大文件、提交长 JSON 或返回大量 HTML 时,数据会被无声截断,导致调试时“看不全”。
- 修改
config/telescope.php中RequestWatcher的配置项:'size_limit' => 1024(单位 KB) - 同时检查
response_size_limit,它控制响应体最大记录长度,也建议同步调高 - 调整后务必清缓存:
php artisan config:clear,否则配置不生效 - 这个值不是越大越好——过大会拖慢单次请求记录速度,尤其在本地 SQLite 环境下容易卡住
生产环境误启用 Telescope 会怎样?
它不会“稍微慢一点”,而是直接引发雪崩:每条请求都写数据库、存完整请求体、记录所有 SQL 绑定、生成大量 JSON 文件,轻则数据库连接耗尽,重则内存溢出崩溃。
-
TELESCOPE_ENABLED=false在.env里不保险——config/telescope.php的enabled闭包可能被覆盖,最稳的是在TelescopeServiceProvider::register()里硬编码:if ($this->app->environment('local')) { Telescope::start($this->app); } - 绝对不要在生产环境设
APP_ENV=local,这是最高频的误操作 - 即使开了 IP 白名单或子域名,只要
APP_ENV是local,Telescope 就会加载路由、中间件、所有 watcher,性能损耗已发生
真正关键的不是“怎么开”,而是“哪些开关必须关”——比如生产环境的 LogWatcher 级别、QueryWatcher 的 with_bindings、RequestWatcher 的 size_limit,这些默认值在开发阶段友好,在线上就是定时炸弹。











