Laravel迁移失败：空数据库导致users表不存在错误

问题根源 #

错误显示在执行迁移前，应用已尝试查询users表（SQL: select * from users where id = 1 limit 1），但此时数据库为空，尚未执行迁移创建表。从堆栈信息来看，触发点在RouteServiceProvider的闭包中，说明你的路由服务提供者或其他启动逻辑里存在提前查询数据库的代码。

解决步骤 #

1. 检查RouteServiceProvider #

打开app/Providers/RouteServiceProvider.php，查找是否有在路由注册前执行的数据库查询代码，比如：

• 试图获取指定用户（如id=1的用户）
• 全局作用域、模型绑定中的查询
• 路由分组前的业务逻辑

临时注释这类代码，或添加表存在判断后再执行：

use Illuminate\Support\Facades\Schema;

// 仅当users表存在时执行查询
if (Schema::hasTable('users')) {
    // 你的查询代码
}

2. 移除启动时的数据库依赖 #

检查config/app.php中的服务提供者列表，临时注释非必要、会触发数据库查询的服务提供者，待迁移完成后再恢复。

另外，确认自定义中间件或全局中间件中没有强制触发认证查询的逻辑——Laravel的artisan migrate默认不会加载web中间件，但服务提供者中的代码仍会执行。

3. 强制执行迁移 #

确认.env文件的数据库配置（DB_DATABASE、DB_USERNAME、DB_PASSWORD）指向新建的空数据库，然后执行：

php artisan migrate --force

4. 手动创建migrations表（可选） #

如果迁移系统未自动创建migrations表，可手动在数据库中执行SQL：

CREATE TABLE migrations (
    id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    migration VARCHAR(255) NOT NULL,
    batch INT UNSIGNED NOT NULL
);

完成后再执行php artisan migrate。

5. 清理缓存 #

清理配置和缓存避免旧配置生效：

php artisan config:clear
php artisan cache:clear

后续注意事项 #

迁移完成后恢复之前注释的代码，建议给涉及数据库查询的启动逻辑添加表存在判断，避免下次清空数据库后重复触发错误。

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