SuperAPI AI 工具集

systematic-debugging-laravel

测试与质量

查看项目

更新于 10-15 22:38

技能介绍

用途:为 Laravel 应用提供系统化调试流程,核心原则是先定位根因再修复,避免随机试错和症状式补丁。适用于任意 Laravel 技术问题,如测试失败、Eloquent 查询与关系问题、认证授权缺陷、校验失败、队列任务失败、路由错误、迁移问题、N+1 与性能问题;在时间紧、修复方案看似明显、已多次尝试失败或对问题理解不充分时尤其适用。

主要能力与流程:分四个阶段,必须逐阶段完成。阶段一根因调查:仔细读错误信息、查看 storage/logs/laravel.log、本地开启 APP_DEBUG=true 与 APP_ENV=local、用 Telescope(composer require laravel/telescope --dev、php artisan telescope:install、php artisan migrate,访问 /telescope)、用 git log --oneline -10 与 git diff HEAD~5 检查近期变更、用 php artisan migrate:status 与 php artisan config:show 检查状态,并通过 Tinker 稳定复现;Eloquent 问题可开启查询日志定位。阶段二模式分析:在代码库中查找可用的同类写法,对照 Laravel 约定与官方文档,识别差异。阶段三假设与验证:提出单一假设,只改一个变量,在 Tinker 中验证。阶段四实现:先写会失败的测试(如 Pest),php artisan test --filter=... 确认失败,再做单一修复,跑全量 php artisan test 并手动验证;若修复无效,少于三次回到阶段一,三次以上应停下来质疑架构并与团队讨论。

Laravel 专用技巧:用 toSql()/getBindings() 查看真实 SQL,用 Model::preventLazyLoading() 捕获 N+1,用 php artisan route:list 排查路由,用 php artisan queue:failed、queue:retry、queue:work --verbose 处理队列,在 failedValidation 中记录校验错误。可与 laravel-debugger、laravel-testing-expert、eloquent-specialist、laravel-performance-optimizer 等代理配合使用。

限制:资料未提供具体收费、价格、平台支持版本等细节,暂未提供。该技能是流程规范而非自动修复工具,需人工执行命令与判断;调试模式仅限本地开启。