SuperAPI AI 工具集

laravel-systematic-debugging

测试与质量

查看项目

更新于 10-16 09:57

技能介绍

该技能为 Laravel 应用提供一套结构化调试流程,核心原则是先查清根因再提出修复,认为只治症状的补丁会浪费时间并引入新缺陷。适用场景包括测试失败、Eloquent 查询问题、认证与授权缺陷、验证失败、队列任务失败、路由错误、迁移问题、N+1 查询及性能问题;在时间紧张、觉得"只需快速改一处"、已尝试多次修复无效或尚未完全理解问题时应优先使用。

流程分四个阶段,必须依次完成。第一阶段根因调查:仔细阅读错误信息,查看 storage/logs/laravel.log,本地开启 APP_DEBUG,使用 Laravel Telescope(composer require laravel/telescope --dev、php artisan telescope:install、php artisan migrate),用 git log/git diff、php artisan migrate:status 与 php artisan config:show 检查近期变更,并通过 php artisan tinker 稳定复现问题;Eloquent 问题可用 DB::listen 或 DB::enableQueryLog() 追踪数据流。第二阶段模式分析:在项目中查找可运行示例,对照 Laravel 约定与官方文档,找出差异。第三阶段提出单一假设并在 tinker 中最小化验证。第四阶段修复根因:先写失败测试(php artisan test --filter=...),只做一处修改,再运行全部测试并手动验证。若修复尝试三次以上仍失败,应停下来质疑架构并与团队讨论。

资料还给出常见场景(N+1、路由模型绑定失效、批量赋值异常)的排查思路,以及 Eloquent、路由(php artisan route:list)、队列(php artisan queue:failed、php artisan queue:retry、php artisan queue:work --verbose)、验证错误的调试技巧,并建议与 laravel-debugger、laravel-testing-expert 等代理配合。限制:资料未提供该技能的收费、价格、授权与安装方式等信息。