直接访问 /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 标签：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 列表按时间倒序排列，显示请求路径、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）
