Laravel修改User表字段后执行migrate:refresh报categories表不存在错误，如何解决？

问题根源 #

执行migrate:refresh时，Laravel会先回滚所有迁移再重新执行，但迁移过程中，项目里的某些代码（比如模型全局作用域、服务提供者启动逻辑、模型boot方法）提前触发了对categories表的查询，此时该表还未被创建，导致报错。

解决步骤 #

1. 检查模型的全局作用域与boot方法 #

• 打开Category模型（或关联模型），查看boot方法里是否有自动执行的查询逻辑或全局作用域，比如：

  protected static function boot()
  {
      parent::boot();
      // 这类直接查询categories表的代码会在迁移时触发报错
      static::addGlobalScope('active', function ($query) {
          $query->where('is_active', true);
      });
      // 或者直接执行了DB查询
      $defaultCategory = Category::first();
  }
  

• 临时注释这类代码，等迁移完成后再恢复；或者给查询逻辑加表存在判断：

  use Illuminate\Support\Facades\Schema;
  
  if (Schema::hasTable('categories')) {
      $defaultCategory = Category::first();
  }
  

2. 排查服务提供者的启动代码 #

• 检查app/Providers下的所有服务提供者（尤其是AppServiceProvider），看boot方法里是否有调用Category模型或查询categories表的逻辑，比如：

  public function boot()
  {
      // 这类代码会在迁移阶段执行，触发报错
      View::share('categories', Category::all());
  }
  

• 同样临时注释或添加表存在判断：

  use Illuminate\Support\Facades\Schema;
  
  if (Schema::hasTable('categories')) {
      View::share('categories', Category::all());
  }
  

3. 单独迁移categories表再执行全量迁移 #

• 找到创建categories表的迁移文件（比如database/migrations/xxxx_xx_xx_xxxxxx_create_categories_table.php），单独执行迁移：

  php artisan migrate --path=database/migrations/xxxx_xx_xx_xxxxxx_create_categories_table.php
  

• 完成后再执行全量迁移命令：

  php artisan migrate:refresh
  

4. 彻底清理缓存 #

确保所有缓存完全清除：

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

5. 强制执行fresh迁移（本地环境） #

如果是本地开发环境，确保.env中APP_ENV=local，执行：

php artisan migrate:fresh --force

后续预防 #

• 不要在模型boot方法或服务提供者boot方法里直接执行数据库查询，必须添加表存在判断；
• 优先使用延迟加载或事件监听，避免在应用启动阶段触发数据库操作。

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