Laravel9 基于PostGIS的字段类型修改迁移无效问题

问题描述 #

我需要在PostGIS数据库中修改字段类型，将原本char(1)类型的person_limit_type字段改为varchar(50)。我编写了两种迁移实现方式，但均未生效：

public function up()
{
    DB::raw("ALTER TABLE $this->voucher_groups_table ALTER COLUMN person_limit_type TYPE VARCHAR(50)");
    DB::raw("ALTER TABLE $this->voucher_groups_table ALTER COLUMN person_limit_type SET DEFAULT NULL");

    Schema::table($this->voucher_groups_table, function(Blueprint $table) {
        $table->string('person_limit_type', 50)->nullable()->change();
    });
}

迁移执行成功后，数据库表中的字段类型仍保持char(1)，这是为什么？

问题原因 #

• DB::raw()未实际执行：Laravel里DB::raw()只是创建一个SQL表达式对象，不会主动把SQL发送到数据库执行。必须用DB::statement()包裹才能触发执行，否则这段代码等于没跑。
• 两种修改方式冲突+依赖缺失：就算前面的原生SQL能执行，后面Schema Builder的change()操作可能因为Laravel对PostGIS的兼容逻辑、两种操作互相干扰导致失效；另外如果没安装doctrine/dbal依赖，Schema Builder的change()方法本身就无法修改字段类型。

解决办法 #

方式一：用原生SQL执行修改 #

直接通过DB::statement()执行PostgreSQL的ALTER语句：

public function up()
{
    DB::statement("ALTER TABLE {$this->voucher_groups_table} ALTER COLUMN person_limit_type TYPE VARCHAR(50)");
    DB::statement("ALTER TABLE {$this->voucher_groups_table} ALTER COLUMN person_limit_type SET DEFAULT NULL");
}

方式二：修复Schema Builder的用法 #

首先确保安装doctrine/dbal（Laravel修改字段类型必须依赖这个扩展）：

composer require doctrine/dbal

然后单独使用Schema Builder的修改逻辑：

public function up()
{
    Schema::table($this->voucher_groups_table, function(Blueprint $table) {
        $table->string('person_limit_type', 50)->nullable()->change();
    });
}

注：PostGIS基于PostgreSQL，char转varchar属于常规字段修改，只要依赖版本适配，就能正常生效。

额外注意 #

• 不要同时混用两种修改方式，避免逻辑冲突
• 可以先注释其中一种，单独测试，定位问题点

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