ThinkPHP版本迁移中的数据库迁移文件处理_数据一致性保障-ThinkPHP-PHP中文网

thinkphp 8 迁移需将文件移至 database/migrations、命名空间改为 database\migrations，改用 db::name()->insert() 替代 $this->table()->insert()，删表前须校验存在性，种子需单独运行，timestamps 不再默认设当前时间。

thinkphp版本迁移中的数据库迁移文件处理_数据一致性保障

ThinkPHP 6 升级到 ThinkPHP 8 后 `migrate:run` 报错 “Class not found”

TP8 移除了对旧版迁移类命名空间的自动兼容，think\migration\command\MigrateRun 这类命令底层已重构，但老迁移文件仍按 TP6 的 app\database\migrations 路径和 App\Database\Migrations\* 命名空间生成，TP8 默认只扫描 database/migrations 下的 PSR-4 类（且要求命名空间为 Database\Migrations\*）。

迁移文件必须移到项目根目录下的 database/migrations（不是 app/database/migrations）
每个迁移类的命名空间要改成 Database\Migrations，例如：class CreateUsersTable extends Migration → 声明为 namespace Database\Migrations;
类名仍需保持时间戳前缀格式，如 20220101000000_create_users_table.php，TP8 不接受下划线以外的分隔符
如果用了自定义基类或抽象迁移逻辑，确保该基类也位于可自动加载路径下，并声明正确命名空间

TP6 的 `up()` 方法里用 `$this->table('users')->insert()` 在 TP8 中失效

TP8 的迁移器废弃了链式 table()->insert() 写法，改用原生查询构造器或独立的 Db 实例。直接调用会抛出 Call to undefined method think\migration\Migrator::table()。

改用 Db::name('users')->insert($data) 或 Db::execute('INSERT INTO users ...')
注意 Db 在迁移中默认不开启事务，如需事务保障，得手动包装：Db::transaction(fn() => Db::name('users')->insert($data))
避免在 up() 中调用模型——模型可能依赖未就绪的配置或中间件，迁移阶段应只用 Db 或原生 PDO
TP8 的 Migrator 类不再继承 Connection，所以所有数据库操作必须显式通过 Db 或传入的 $schema 对象（仅限结构变更）

从 TP6 迁移过来的 `down()` 里删表失败，提示 “Table doesn’t exist”

不是表真不存在，而是 TP8 的 down() 执行时，当前数据库连接可能已切换到测试库、内存库，或迁移系统误判了环境配置。更常见的是：TP6 允许在 down() 中写 $this->dropTable('users')，但 TP8 的 Schema 对象默认不支持动态删表，且未做存在性校验。

务必在删表前加存在性判断：if (Db::query("SHOW TABLES LIKE 'users'")) { Db::execute('DROP TABLE users'); }
不要依赖 $this->schema()->dropIfExists('users') —— TP8 的 schema() 方法返回的是结构构建器，不支持运行时删表操作
若用的是多数据库连接，在 up()/down() 开头显式指定连接：Db::connect('master')->name('users')->...)
TP8 默认关闭了 MySQL 的 FOREIGN_KEY_CHECKS，但删有外键的表前仍建议手动关掉：Db::execute('SET FOREIGN_KEY_CHECKS = 0');

迁移执行后数据不一致：种子数据没跑、字段类型被重置、索引丢失

TP8 把迁移（migration）和种子（seed）彻底解耦，默认 migrate:run 不触发 seed，且结构变更命令（如 changeColumn）在部分驱动下会重建表，导致数据丢失。

种子必须单独运行：php think seed:run，且种子类也要迁移到 database/seeds，命名空间改为 Database\Seeds
慎用 changeColumn：MySQL 下它会 ALTER TABLE ... MODIFY，但 SQLite 或 SQL Server 可能走重建流程；改类型优先考虑 renameColumn + 新增 + 迁移数据 + 删旧列
索引必须显式定义：$table->index('email') 不再隐式创建，漏写就会丢索引
TP8 的迁移回滚（migrate:rollback）默认只退一步，且不会自动清理已插入的种子数据 —— 数据一致性得靠人盯，不能靠框架兜底