改字段必须新建迁移、装 doctrine/dbal、显式调用 change()，三者缺一不可；否则 migrate 看似成功但结构未变，因 Laravel 默认跳过未声明变更的列，change() 是触发 Doctrine DBAL 解析的必要开关。
改字段必须新建迁移文件、装 doctrine/dbal、显式调用 change()，三者缺一不可；否则 php artisan migrate 看似成功，数据库结构实际没变。
为什么直接改列定义不生效？
Laravel 默认跳过“未声明变更”的列。哪怕你在 Schema::table() 里把 $table->string('email') 改成 $table->text('email')，只要没加 ->change()，它就当没这回事。
-
change()不是语法糖，而是触发 Doctrine DBAL 底层 SQL 解析的开关 - Laravel 9+ 默认不带
doctrine/dbal，不装就会静默跳过变更 - MySQL 8.0+ 和 PostgreSQL 支持较好；SQLite 直接报错
SQLSTATE[HY000]: General error: 1 Cannot modify column
改字段类型或属性的正确写法
必须走新迁移、装依赖、显式 change()，且只在 Schema::table() 闭包内有效。
- 命令：
php artisan make:migration change_email_type_on_users_table --table=users - 装依赖：
composer require doctrine/dbal（Laravel 10+ 强制要求） - 迁移内容：
Schema::table('users', function (Blueprint $table) {
$table->text('email')->nullable()->change(); // ✅ 类型+属性一起改
$table->string('name', 100)->change(); // ✅ 改长度
});
- 注意：改主键、索引、外键约束不能靠
change()，得单独处理 - MySQL 配置里要确认
'engine' => 'InnoDB'，否则可能报错1005
重命名字段不能用 change()
change() 只改定义，不改名字；想改字段名，必须用 renameColumn()，且不能和 change() 合并在同一个闭包里。
- 正确写法：
Schema::table('users', function (Blueprint $table) {
$table->renameColumn('user_name', 'name'); // ✅ 独立调用
});
- 错误写法：
$table->renameColumn('old', 'new')->change()—— 第二个操作会被忽略 - PostgreSQL 下若该列被视图或函数引用，
renameColumn()会直接拒绝，需先清理依赖 - 原字段有索引（如
index('user_name')），重命名后索引名不会自动更新，得手动删旧建新
生产环境改字段前必须检查的三件事
很多失败不是语法问题，而是数据或约束层面的冲突。
- 外键约束：报错
SQLSTATE[HY000]: General error: 1832 Cannot change column 'xxx': used in a foreign key constraint，就得先删外键再改，改完再加回 - 数据兼容性：把
string(255)改成string(50)，已有超长数据会被截断，migrate不提示也不报错 -
down()必须严格逆向：比如up()用了renameColumn()，down()就得用反向重命名，不能留空或写错顺序
真正容易被忽略的是：迁移只动结构，不动数据校验。字段改了之后，原有数据是否还合法，得你用 DB::statement() 或原生 SQL 自己查一遍。
