跨大版本升级必须重审并同步表结构，小版本升级需验证外键、索引、字符集等隐式变更；模型字段与数据库不一致时须补迁移文件，否则触发PDO异常。
升级ThinkPHP时数据库表结构要不要一起改，取决于你升的是什么版本——跨大版本（如5→6、6→8）必须重审迁移逻辑和表结构一致性，而小版本（如8.0.1→8.0.2）通常不改动DDL，但需验证外键、索引、字符集是否被底层驱动悄悄修正。
跨大版本升级：表结构必须重新对齐
TP5升TP6或TP6升TP8时，框架不再兼容旧版迁移机制与模型反射逻辑，【直接复用老迁移文件可能漏建字段、错设默认值、丢失约束】。你不能假设“升级完框架，表还能照常用”。
第一步：清空开发环境数据库，执行php think migrate:reset → php think migrate:run，得到干净结构；
第二步：用mysqldump --no-data --skip-triggers -h127.0.0.1 -u root -p dev_db > dev_schema.sql导出纯结构；
立即学习“PHP免费学习笔记（深入）”；
第三步：同样方式导出生产库schema.sql，用diff -u dev_schema.sql prod_schema.sql比对差异；
第四步：人工检查差异项——重点看ENGINE=InnoDB是否统一、utf8mb4_unicode_ci vs utf8mb4_0900_ai_ci是否混用、外键名是否含非法字符（如`user_id_refs_id`在TP8中会被自动转义为`user_id_refs_id_1`）；
第五步：把确认安全的ALTER语句打包成新迁移文件，例如20260806000000_fix_foreign_key_collation.php，再跑一次migrate:run。
小版本升级：先查think_migration表再动表
TP8.0.0升到TP8.0.3这类patch更新，框架本身不改表结构，但MySQL驱动或PDO层可能调整timestamp字段行为。别跳过校验。
方法一：运行php think migrate:status，确认所有迁移记录状态为Migrated且无Pending；
方法二：直连数据库查think_migration表，对比version字段最大值与database/migrations/下最新文件时间戳是否一致；
方法三：执行SELECT COUNT(*) FROM information_schema.COLUMNS WHERE TABLE_SCHEMA='your_db' AND COLUMN_NAME='update_time' AND DATA_TYPE='timestamp' AND DATETIME_PRECISION=0；如果返回0，说明TP8.0.2起已强制将datetime精度设为6，你得手动ALTER COLUMN update_time TYPE datetime(6)。
模型字段与数据库实际结构不一致怎么办
升级后发现User::get(1)报错“Column not found: 1054 Unknown column 'is_deleted'”，说明模型里写了软删除但表没加字段——这不是框架问题，是你漏跑了迁移。
方法一：立刻补一个迁移文件，php think migrate:create AddIsDeletedToUserTable；
方法二：在up()里写$this->table('user')->addColumn('is_deleted', 'tinyint', ['default' => 0, 'comment' => '软删除标记'])->update();
方法三：别用Db::name('user')->insert()往缺字段的表里插数据，【否则会触发PDO异常：SQLSTATE[HY000]: General error: 1364 Field 'is_deleted' doesn't have a default value】，必须先补字段再写入。
