必须同步更新ignition和collision，否则artisan崩溃或页面空白；需先卸载旧包facade/ignition和nunomaduro/collision，再安装spatie/laravel-ignition:^2.4与nunomaduro/collision:^8.1--dev，并手动注册ignition服务提供者。
升级 Laravel 11 时必须同步更新 Ignition 和 Collision，否则 artisan 命令会直接崩溃或错误页面空白——这两个包已从 Laravel 10 的默认栈中移除，且签名完全不兼容。
确认当前安装状态
运行 composer show spatie/laravel-ignition nunomaduro/collision 查看实际版本。若输出显示 facade/ignition 或 ^6.x 类版本，说明仍卡在旧生态链里，不能跳过清理步骤。
【必须先卸载旧包】 执行 composer remove facade/ignition nunomaduro/collision。不清理就直接 require 新版，Composer 会报 dependency conflict 并中断后续操作。
安装 Laravel 11 兼容的调试工具组合
方法一：一次性安装官方推荐组合
执行 composer require spatie/laravel-ignition:^2.4 nunomaduro/collision:^8.1 --dev。这组版本已通过 Laravel 11.0.x 官方测试套件验证，php artisan tinker 和异常页面渲染均能正常工作。
方法二：仅需 Ignition（轻量调试）
如果你项目不用 Collision（比如已用 Sentry 或自定义异常处理器），只装 Ignition 即可：composer require spatie/laravel-ignition:^2.4 --dev。注意：Laravel 11 不再自动注册 Ignition 的服务提供者，必须手动在 bootstrap/app.php 中添加 ->withProviders([\Spatie\LaravelIgnition\IgnitionServiceProvider::class])。
验证并修复常见报错
第一步：清空配置缓存 → 运行 php artisan config:clear
第二步：启动开发服务器 → 执行 php artisan serve
第三步：触发一个故意错误（例如访问不存在的路由）→ 观察是否出现带「Ignition」logo 的蓝色调试面板。如果页面空白或报 Class 'Facade\Ignition\Facades\Ignition' not found，说明旧 facade 引用残留，需全局搜索项目中 use Facade\Ignition 或 Ignition:: 并删除。
第四步：检查终端日志 → 若看到 [2026-08-06 16:14:22] local.ERROR: Call to undefined method Illuminate\Foundation\Application::getExceptionHandler()，证明 Collision 版本不对，立刻退回上一步重装 ^8.1。
