如何为现有数据表添加新的ENUM值‘pending’？

数据老陈

2026-7-6

解决Laravel迁移添加ENUM值无效的问题

问题原因

Laravel原生Schema Builder对MySQL的ENUM类型变更支持有限，直接在已执行过的迁移文件中重新定义ENUM集合，执行php artisan migrate不会触发字段更新，因为框架无法识别ENUM集合的细微变化。

正确解决方案

方法1：使用原生SQL语句修改

创建新的迁移文件（不要修改已执行的迁移文件，这是Laravel迁移的最佳实践），在up()方法中执行原生SQL来更新ENUM字段：

public function up()
{
    // 替换your_table_name为实际表名，status为你的ENUM字段名
    DB::statement("ALTER TABLE your_table_name MODIFY COLUMN status ENUM('paid', 'unpaid', 'pending', 'free') NOT NULL DEFAULT 'unpaid'");
}

public function down()
{
    // 回滚时移除pending值，恢复原ENUM集合
    DB::statement("ALTER TABLE your_table_name MODIFY COLUMN status ENUM('paid', 'unpaid', 'free') NOT NULL DEFAULT 'unpaid'");
}

执行迁移命令：

php artisan migrate

方法2：借助第三方扩展包增强支持

如果需要频繁修改ENUM类型，可以安装laravel-doctrine/dbal扩展包来增强Schema Builder的能力：

安装扩展包：

composer require laravel-doctrine/dbal

创建新迁移文件，使用change()方法更新ENUM：

public function up()
{
    Schema::table('your_table_name', function (Blueprint $table) {
        $table->enum('status', ['paid', 'unpaid', 'pending', 'free'])->change();
    });
}

public function down()
{
    Schema::table('your_table_name', function (Blueprint $table) {
        $table->enum('status', ['paid', 'unpaid', 'free'])->change();
    });
}