laravel 12 修改表结构必须新建迁移文件并用schema::table()操作，禁改旧文件；需装doctrine/dbal才支持change()；添加/删除字段、索引须在up()和down()中严格可逆；大表慎用change()和dropcolumn()以防锁表。
在 Laravel 12 中，修改现有数据库表结构主要通过生成新的迁移文件并使用 Schema 构建器操作实现。不能直接编辑旧迁移文件，也不能在已运行的迁移中追加逻辑——必须创建独立迁移来描述变更。
生成新迁移文件
使用 Artisan 命令创建一个专用于修改表结构的迁移：
-
基本命令：
php artisan make:migration add_status_to_users_table --table=users（推荐带上--table参数，让文件名更明确） - 若只是改字段或删字段，不涉及新增列，也可省略
--table，但建议仍保持语义清晰，比如php artisan make:migration change_email_column_in_users_table - 生成的文件位于
database/migrations/，时间戳前缀确保执行顺序
在 up() 和 down() 中安全定义变更
迁移的核心是 up()（应用变更）和 down()（回滚变更），两者必须可逆且匹配：
-
添加字段：
Schema::table('users', function (Blueprint $table) { $table->string('status')->default('active'); }); -
修改字段：需安装
doctrine/dbal（Laravel 12 默认未包含，运行composer require doctrine/dbal）；然后用$table->string('email')->nullable()->change(); -
删除字段：
$table->dropColumn('phone');（支持单个或数组：['phone', 'address']） -
添加索引/唯一约束：
$table->index('status'); $table->unique('email'); - down() 方法要反向操作：加了字段就删字段，加了索引就删索引，改了类型就尽量还原（如改回原长度、是否 nullable）
执行与验证迁移
写完迁移后，按步骤操作确保安全：
- 先在本地开发环境运行：
php artisan migrate，观察控制台输出是否成功 - 检查数据库，确认字段、索引、默认值等符合预期（可用 phpMyAdmin、TablePlus 或
php artisan tinker查表结构） - 测试回滚：
php artisan migrate:rollback，确认数据表恢复到变更前状态（注意：dropColumn回滚无法恢复数据，仅恢复结构） - 上线前，建议在预发布环境完整走一遍 migrate → rollback → migrate 流程
注意事项与避坑点
实际操作中容易忽略的关键细节：
- 不要修改已提交的旧迁移文件：已推送到团队或生产环境的迁移一旦被运行，再改内容会导致 checksum 不匹配报错
- 大表慎用 change() 和 dropColumn()：MySQL 中这些操作会锁表，线上执行可能影响服务；超 10 万行建议用 pt-online-schema-change 或分批次处理
-
字符串字段长度要显式声明：Laravel 12 的 MySQL 默认引擎为 InnoDB，
$table->string('name')默认是 255，但如果你需要 500，必须写$table->string('name', 500) -
外键变更需手动处理：添加外键前确保字段已存在且类型一致（如
user_id是 unsignedBigInteger）；删除外键要先dropForeign()再删字段
