空数据库执行Laravel php artisan migrate报错：portals表不存在

这种情况我在维护Laravel 5.x项目时碰到过好几次，核心问题是Laravel在执行任何Artisan命令前，都会完整加载应用的服务容器与核心代码——如果你的项目里有代码在启动阶段（比如服务提供者、模型全局作用域、路由文件）直接查询portals表，就会在迁移执行前触发这个错误，哪怕你已经有创建该表的迁移文件。

下面是一步步的排查和解决方法：

1. 定位启动时依赖portals表的代码 #

先找出哪些代码在应用启动时就会触发数据库查询：

• 检查app/Providers目录下的所有服务提供者，重点看boot()方法，有没有直接查询portals表、给全局变量赋值或者注册依赖该表数据的逻辑；
• 检查Portals模型（或相关模型）的boot()方法，是否有全局作用域用到了portals表的关联或数据查询；
• 查看routes/web.php或routes/api.php，有没有闭包路由里直接执行了portals表的查询（Laravel会预加载路由文件，哪怕是执行Artisan命令）；
• 检查自定义中间件，有没有在处理请求前（包括Artisan命令的请求上下文）查询portals表的逻辑。

2. 临时绕过依赖，先执行迁移 #

找到依赖代码后，你可以通过以下方式临时绕过，让迁移能正常执行：

方式一：添加环境/命令判断 #

在依赖代码外层加判断，只在非Artisan命令环境下执行，或者排除migrate相关命令：

// 比如在服务提供者的boot方法里
if (!app()->runningInConsole() || (app()->runningInConsole() && !in_array($argv[1], ['migrate', 'migrate:fresh', 'migrate:install']))) {
    // 原来依赖portals表的代码逻辑
}

或者直接判断表是否存在：

use Illuminate\Support\Facades\Schema;

if (Schema::hasTable('portals')) {
    // 执行依赖portals表的逻辑
}

方式二：临时注释依赖代码 #

如果上面的判断不好加，可以先把依赖portals表的代码注释掉，执行完迁移后再恢复。这是最直接的临时方案。

3. 其他排查点 #

• 确认数据库配置正确：检查.env文件里的DB_DATABASE、DB_USERNAME、DB_PASSWORD是否指向你的新本地数据库，避免连接到了旧的不存在该表的数据库；
• 检查迁移文件顺序：Laravel是按迁移文件名的时间戳前缀排序执行的，确保创建portals表的迁移文件时间戳早于其他依赖它的迁移文件（比如如果有迁移要给其他表加外键关联portals，必须先创建portals表）；
• 清理缓存：如果重新克隆仓库后还是有问题，手动删除bootstrap/cache目录下的所有文件（避免残留的配置缓存导致的异常）。

总结 #

只要解决了“启动阶段就查询未创建的表”这个核心问题，php artisan migrate就能正常执行，之后其他Artisan命令也不会再报错了。

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