Laravel + Telescope 调试神器用法【提效】

胖敏酱_1795

胖敏酱_1795

2026-07-11

404人浏览

原创

Telescope 装完无请求记录,需同时满足四条件:APP_ENV=local、TELESCOPE_ENABLED=true、TelescopeServiceProvider gate() 返回true、config/telescope.php中enabled配置生效;Ajax请求默认不显示在Requests页,需用telescope-toolbar或手动record;慢查询未标红因阈值过高或路径被ignore;prune默认保留异常,清异常需加--force。

laravel + telescope 调试神器用法【提效】

Telescope 装完却看不到请求记录?检查中间件和启用状态

装完 php artisan telescope:install 和 php artisan migrate 后没数据,大概率是 Telescope 没真正跑起来。它默认只在本地环境(APP_ENV=local)且通过中间件授权后才记录数据。

  • 确认 APP_ENV 是 local,不是 production 或 staging
  • 检查 app/Providers/TelescopeServiceProvider.php 中的 gate() 方法是否返回 true —— 默认只允许 request()->ip() === '127.0.0.1',如果你用 Docker、Valet 或远程开发,IP 不匹配就会静默丢弃所有记录
  • 确保 TELESCOPE_ENABLED=true 在 .env 里显式设置,否则即使环境正确也可能被关掉
  • config/telescope.php 中的 'enabled' => env('TELESCOPE_ENABLED', true) 必须生效,别被其他配置覆盖

为什么 Ajax 请求不显示在 Requests 标签页?它根本不在那里

Telescope 的 Requests 标签页只展示完整 HTTP 请求-响应周期(即页面跳转或 API 入口),而前端发起的 fetch 或 XMLHttpRequest 默认不会出现在这里 —— 它们被归类为「后台请求」,需要额外工具才能捕获。

  • 原生 Telescope 不监听 XHR/fetch,除非你手动触发 Telescope::recordRequest() 或用中间件包裹这些路由
  • 真正能自动抓取 Ajax 的是 laravel-telescope-toolbar(注意不是官方 Telescope),它通过浏览器端注入脚本+服务端钩子实现,安装后会在底部出现工具栏,Ajax 面板独立显示
  • 如果你用 Livewire,它自带 X-Livewire header,Telescope Toolbar 能识别并归类,但纯 API 路由如 /api/posts 仍需确认是否在 only_paths 配置中放开

慢查询没标红?检查 QueryWatcher 的 slow 阈值和 ignore_paths

数据库查询没高亮,并非没监控,而是条件没触发。Telescope 的 QueryWatcher 默认只把执行时间超过 100 毫秒的查询标记为「慢」,且会跳过某些路径。

Laravel Cloud
Laravel Cloud

Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。

下载
  • 修改 config/telescope.php 中 Watchers\QueryWatcher::class 的 'slow' => 50,调低阈值便于测试
  • 确认 'ignore_paths' => ['nova-api*', 'horizon*'] 没误删你正在调试的路由前缀,比如你查的是 /admin/users,但配置里写了 'admin*' 就全被跳过了
  • ignore_packages => true 会过滤掉 Eloquent 内部调用(如 Model::query() 初始化),导致部分查询不出现,调试时建议设为 false

prune 命令删不掉异常?因为 --keep-exceptions 默认开着

php artisan telescope:prune 默认保留异常记录,这是有意设计,不是 bug。如果你发现日志表体积大但异常没减少,很可能就是这个开关在起作用。

  • 运行 php artisan telescope:prune --hours=48 只清理 48 小时前的非异常数据,异常仍保留
  • 要连异常一起清,必须显式加 --force: php artisan telescope:prune --hours=48 --force
  • php artisan telescope:clear 才是无差别清空全部,慎用,它绕过时间判断直接 truncate 表
  • 生产环境建议用 --keep-exceptions + 定时任务,既省空间又保关键错误线索

Telescope 的坑多数藏在配置层级叠加里:环境变量、配置文件、中间件 gate、watcher 自身开关,四层都得对上才真正生效。别只改一个地方就以为搞定了。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

laravel

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
开发工具有哪些
开发工具有哪些

开发工具有:1、集成开发环境IDE;2、版本控制系统VCS;3、自动化构建工具;4、测试工具;5、代码分析工具。本专题为大家提供开发工具有哪些的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3426

5

laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

897

10

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

2024.04.09

875

9

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

2548

10

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

5241

7

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

2025.08.05

7790

22

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

2025.08.05

5076

13

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.05

9529

7

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

2026.03.04

1556

29

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 234人学习

Composer手册
Composer手册

共0课时 | 0人学习