当 Laravel 项目首次运行 php artisan migrate 报错“Table 'xxx.migrations' doesn't exist”时，说明用于记录迁移状态的系统表尚未初始化；只需执行 php artisan migrate:install 即可自动创建该表。

当 laravel 项目首次运行 `php artisan migrate` 报错“table 'xxx.migrations' doesn't exist”时，说明用于记录迁移状态的系统表尚未初始化；只需执行 `php artisan migrate:install` 即可自动创建该表。

Laravel 使用 migrations 表来追踪已执行的迁移文件及其执行顺序（通过 batch 和 migration 字段）。该表并非随框架自动创建，而需在首次迁移前显式初始化——尤其在克隆已有项目、数据库为空或重置环境时极易遇到此问题。

✅ 正确解决步骤如下：

1. 确认数据库连接正常
   检查 .env 中配置是否与实际 MySQL 实例匹配（如你已将 XAMPP MySQL 端口改为 3307，则 DB_PORT=3307 必须准确无误）：

   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3307
   DB_DATABASE=job-board
   DB_USERNAME=root
   DB_PASSWORD=

   ✅ 建议执行 php artisan tinker 后运行 DB::connection()->getPdo(); 验证连通性，避免因凭据或端口错误导致静默失败。

2. 初始化 migrations 表
   运行以下命令一次性创建 migrations 表（仅需执行一次）：

   php artisan migrate:install

   该命令会在当前 DB_DATABASE（即 job-board）中创建结构如下的一张表：

   

   Laravel Creem Agent

   Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

   下载

   CREATE TABLE `migrations` (
     `id` int unsigned NOT NULL AUTO_INCREMENT,
     `migration` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL,
     `batch` int NOT NULL,
     PRIMARY KEY (`id`)
   ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

3. 再执行迁移
   初始化成功后，即可正常运行：

   php artisan migrate

   Laravel 将从此表读写记录，确保迁移幂等性与回滚可靠性。

⚠️ 注意事项：

• migrate:install 在 Laravel 8+ 中仍有效，但官方文档已将其标记为“legacy”命令（因 migrate 命令内部已自动处理初始化逻辑）；不过当数据库完全为空且未执行过任何迁移时，手动调用仍是最稳妥方案。
• 若执行 migrate:install 报错（如权限不足），请确认数据库用户 root 具有对 job-board 库的 CREATE 权限。
• 切勿手动创建 migrations 表——必须由 Artisan 命令生成，以保证字段类型、索引及字符集与 Laravel 版本兼容。

完成以上操作后，你的迁移流程即可恢复正常，后续 php artisan migrate:fresh 或 rollback 等命令也将可靠运行。