Laravel部署及升级时缺失facade/ignition引发类找不到错误求助

问题根源 #

你的项目中Facade\Ignition\IgnitionServiceProvider被全局注册（而非仅开发环境），但facade/ignition属于require-dev依赖，执行composer install --no-dev时不会安装，导致生产环境找不到类；升级Laravel9替换为spatie/laravel-ignition后，旧的服务提供者注册残留，依然触发错误。

解决方案 #

1. 移除全局的Ignition服务提供者注册 #

打开config/app.php，检查providers数组，找到类似以下的代码并删除：

Facade\Ignition\IgnitionServiceProvider::class,

Laravel 8+默认会自动在local环境注册Ignition，无需手动全局添加。如果需要手动控制，可在app/Providers/AppServiceProvider.php的register方法中添加：

public function register()
{
    if ($this->app->environment('local')) {
        $this->app->register(\Facade\Ignition\IgnitionServiceProvider::class);
        // 升级到Laravel9后替换为：
        // $this->app->register(\Spatie\LaravelIgnition\IgnitionServiceProvider::class);
    }
}

2. 清理所有缓存文件 #

部署或升级时，缓存的配置/路由可能残留旧的服务提供者信息，执行以下命令清空：

php artisan config:clear
php artisan cache:clear
php artisan route:clear
php artisan view:clear

生产环境部署完成后，再重新生成配置缓存（确保配置无dev依赖）：

php artisan config:cache

3. 升级Laravel9的正确流程 #

如果要升级到Laravel9，需按以下步骤操作：

• 先完成上述1、2步骤，确保Laravel8生产环境能正常运行
• 修改composer.json：
  • 将laravel/framework改为^9.0
  • 将require-dev中的facade/ignition替换为"spatie/laravel-ignition": "^1.0"
  • 同步更新其他依赖版本（比如barryvdh/laravel-debugbar需升到^3.8，beyondcode/laravel-websockets需升到^2.0，确保兼容Laravel9）
• 执行更新：

composer update

• 运行Ignition安装命令生成配置：

php artisan ignition:install

• 再次清理缓存，确保新配置生效

4. 验证自动加载配置 #

确保composer.json的autoload和autoload-dev分区正确，没有在autoload中引用dev环境的类。执行以下命令重新生成自动加载文件：

composer dump-autoload --optimize

内容的提问来源于stack exchange，提问作者Hillcow