Laravel迁移未创建预期列，仅生成默认列的原因排查

• 迁移文件编写失误

  • 检查自定义列的代码语法：比如是否写错列类型方法（把string()写成str()）、是否遗漏必要的闭合符号，或者把列定义写在了up()方法外面。示例正确写法：

    public function up()
    {
        Schema::create('posts', function (Blueprint $table) {
            $table->id();
            // 自定义列必须写在这个闭包内
            $table->string('title');
            $table->text('content');
            $table->timestamps();
        });
    }
    

  • 确认没有因语法错误导致自定义列代码块失效，比如括号不匹配会让后续列定义被忽略。

• 迁移未真正执行

  • 核对是否运行了正确的命令：确保执行的是php artisan migrate，而非回滚或刷新类命令。
  • 查看数据库的migrations表：如果目标迁移文件的记录已存在，说明你是先执行了迁移再修改的文件，后续修改不会自动生效。需要回滚后重新执行：

    php artisan migrate:rollback
    php artisan migrate
    

  • 检查迁移文件名：必须遵循YYYY_MM_DD_HHMMSS_create_xxx_table.php的格式，命名错误会导致Laravel无法识别该迁移。

• 缓存或配置偏差

  • 清除迁移缓存：Laravel可能缓存了旧的迁移文件，执行php artisan migrate:clear后再重新迁移。
  • 核对数据库连接：检查config/database.php中的配置，确认Laravel连接的数据库和你查看的是同一个，避免查错库的尴尬。

• 数据库权限或报错

  • 确认数据库用户权限：比如MySQL用户需要ALTER权限才能修改表结构，权限不足会导致迁移静默失败。
  • 查看Laravel日志：storage/logs/laravel.log里会记录迁移时的错误细节，比如列名违反约束、数据类型不兼容等。

• 迁移操作冲突

  • 检查是否有多个迁移操作同一张表：比如一个迁移创建表，另一个迁移本该添加列，但执行顺序错误或代码写错，导致列未被添加。
  • 如果是修改已有表的迁移，确认表名是否正确：比如用Schema::table('users', ...)而非Schema::create('users', ...)，避免重复创建表覆盖原有结构。

内容的提问来源于stack exchange，提问作者Muhammad Ahmad Sher