Windows环境下Laravel迁移仅成功创建首个表的问题排查

首先可以明确：在Laravel中执行php artisan migrate时，应该一次性按顺序执行所有未完成的迁移文件，而不是每次只跑第一个。你遇到的问题肯定是某个环节出了问题，下面是最常见的几个排查方向和解决办法：

1. 检查迁移文件的命名规范 #

Laravel是通过迁移文件名开头的时间戳前缀来识别和排序迁移的（比如2024_05_20_000000_create_users_table.php）。如果你手动创建了Role或Department的迁移文件，没有用php artisan make:migration命令生成，或者删掉了时间戳前缀，Laravel会直接忽略这些文件，导致每次只有第一个带正确时间戳的Users表迁移被执行。

解决办法：

• 用php artisan migrate:status命令查看Laravel识别到的迁移列表：已执行的会标Ran，未执行的标Pending。如果Role/Department的迁移不在列表里，说明命名有问题。
• 要么用php artisan make:migration create_roles_table和php artisan make:migration create_departments_table重新生成规范的迁移文件，要么手动给现有文件加上正确的时间戳前缀（注意时间戳要比Users的晚，保证执行顺序正确）。

2. 排查迁移文件的语法错误 #

如果迁移文件本身有语法错误（比如字段定义写错、拼写错误、缺少分号等），Windows的cmd/powershell可能不会默认显示详细错误，导致看起来只执行了第一个表，实际是后续迁移因为错误中断了。

解决办法：

• 执行迁移时加上详细日志输出：php artisan migrate -v，这样能看到执行过程中的所有错误信息，定位到具体哪个迁移文件出了问题。
• 检查Role和Department的迁移文件，确保up()方法里的表结构定义没有语法错误，比如：

  Schema::create('roles', function (Blueprint $table) {
      $table->id();
      $table->string('name');
      $table->timestamps(); // 注意不要漏了分号这类细节
  });
  

3. 检查PHP执行超时问题 #

Windows环境下，如果迁移过程中PHP执行超时，会导致脚本中途终止，后续的迁移无法完成。这种情况在表结构复杂或者数据量较大时可能出现，但你的情况是刚创建表，概率相对低，但也可以排查。

解决办法：

• 临时调整PHP超时时间执行迁移：php -d max_execution_time=300 artisan migrate（300代表300秒，可根据情况调整）。
• 或者修改php.ini文件中的max_execution_time参数，调大后重启命令行再执行。

4. 检查文件编码问题 #

如果迁移文件包含中文注释或特殊字符，且文件编码不是UTF-8无BOM格式，PHP在解析时可能会出错，导致迁移中断。

解决办法：

• 用编辑器（比如VS Code）打开迁移文件，将编码设置为UTF-8（无BOM），去掉不必要的中文注释后再尝试执行。

最后：别用重命名绕路，找到根本原因 #

你现在通过重命名的方式解决只是临时方案，按照上面的步骤排查，很快就能找到问题所在，一次性解决所有迁移的执行问题。

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