直接访问 /telescope 可查看请求与异常记录,但需确保 Telescope 正确安装、启用 RequestWatcher 和 ExceptionWatcher、APP_ENV=local、已运行迁移且 TelescopeServiceProvider 已注册。

直接访问 /telescope 路径即可查看请求与异常记录,但前提是 Telescope 已正确安装、启用对应监控器,且环境配置匹配。面板本身不自动显示数据,必须确保底层采集链路畅通。
确认请求记录已启用
Telescope 默认不会记录所有请求,需手动开启 RequestWatcher:
- 检查 config/telescope.php 中
'Laravel\Telescope\Watchers\RequestWatcher' => true是否存在且值为 true - 确保 APP_ENV=local(仅 local 环境默认启用 watcher;dev/staging 等环境需显式配置)
- 若使用 Laravel 11+,确认 App\Providers\TelescopeServiceProvider 已在 config/app.php 的
providers数组中注册 - 运行过
php artisan migrate,否则请求数据无法写入数据库,页面为空
在面板中定位请求详情
进入 /telescope 后,点击左侧导航栏的 Requests 标签:
- 列表按时间倒序排列,显示请求路径、HTTP 方法、状态码、耗时和 IP
- 点击某条请求,展开完整详情页:含请求头、请求体(如 JSON 或表单数据)、响应头、响应内容(可折叠)、中间件执行顺序
- 向下滚动可见关联的 Queries、Exceptions、Logs 等子项——这些是该次请求生命周期内触发的其他事件
- 若请求触发了数据库查询,Queries 区域会显示每条 SQL、绑定参数、执行时间及调用栈(点击 Trace 可定位到具体代码行)
查看异常记录的正确方式
异常由 ExceptionWatcher 自动捕获,无需额外触发:
- 访问 /telescope → 左侧点击 Exceptions
- 列表展示异常类型、错误消息、发生时间、所属请求 ID(如有)
- 点击任一异常,进入详情页:完整堆栈跟踪、出错文件与行号、上下文变量(如 request input、session 数据等)
- 若异常发生在某次 HTTP 请求中,页面顶部会显示「Related Request」链接,一键跳转回原始请求上下文
排查看不到数据的常见原因
页面能打开但无任何请求或异常记录,通常不是功能失效,而是配置或环境问题:
- APP_ENV 不是 local,即使 APP_DEBUG=true 也无效
- RequestWatcher 或 ExceptionWatcher 在 config/telescope.php 中被设为 false
- 漏执行
php artisan migrate,导致 telemetry 表缺失,写入静默失败 - Laravel 11+ 未手动注册 TelescopeServiceProvider,服务提供者未加载
- 路由被 ignore_paths 过滤(如配置了
['/telescope', '/api/health'],而你测试的是 /api/health)


















