Laravel 修改已有表字段注释时出现tinyInteger类型报错如何解决

Laravel 修改字段的change()方法底层依赖 Doctrine DBAL 库，该库默认没有对 MySQL 原生的tinyint类型做映射，所以调用tinyInteger()->change()时会识别不到对应的字段类型。

方案1：使用原生SQL执行（更简单，推荐仅修改注释场景使用） #

直接在migration中执行数据库原生的修改字段语句，绕过Doctrine的类型校验：

• up()方法代码：

// 把<你的表名>替换为实际的表名称
public function up()
{
    DB::statement("ALTER TABLE `<你的表名>` MODIFY COLUMN `role` TINYINT DEFAULT 2 COMMENT 'new comment' AFTER `ID`");
}

• down()方法回滚代码：

public function down()
{
    DB::statement("ALTER TABLE `<你的表名>` MODIFY COLUMN `role` TINYINT DEFAULT 2 COMMENT 'old comment' AFTER `ID`");
}

注意：如果你的项目需要兼容多种数据库（比如同时适配MySQL和PostgreSQL），不建议用原生SQL方案，选择方案2更合适。

方案2：注册Doctrine类型映射（兼容链式调用写法） #

先给Doctrine注册tinyint类型的映射规则，再执行原本的修改逻辑：

• 首先确保已经安装依赖：
  composer require doctrine/dbal
• 完整的migration代码示例：

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
use Illuminate\Support\Facades\DB;

return new class extends Migration
{
    public function up()
    {
        // 注册类型映射
        DB::getDoctrineSchemaManager()
            ->getDatabasePlatform()
            ->registerDoctrineTypeMapping('tinyint', 'integer');

        Schema::table('<你的表名>', function (Blueprint $table) {
            $table->tinyInteger('role')->default(2)->after('ID')->comment("new comment")->change();
        });
    }

    public function down()
    {
        // 回滚也需要先注册映射
        DB::getDoctrineSchemaManager()
            ->getDatabasePlatform()
            ->registerDoctrineTypeMapping('tinyint', 'integer');

        Schema::table('<你的表名>', function (Blueprint $table) {
            $table->tinyInteger('role')->default(2)->after('ID')->comment("old comment")->change();
        });
    }
};

内容的提问来源于stack exchange，提问作者rod james