yii1.1.32升级至yii2.0.55必须执行三重数据兜底：第一步全库mysqldump加系统库导出；第二步哈希校验与空实例导入验证；第三步人工记录自定义用户字段，否则永久丢失。
在将Yii1.1.32项目升级到Yii2.0.55的过程中，数据库表结构、迁移机制、用户权限存储方式及系统表逻辑均发生根本性变化，直接覆盖部署或忽略数据映射极易导致用户表清空、外键丢失、权限字段截断等不可逆数据丢失。
升级前必须完成的三重数据兜底
第一步：用mysqldump导出全库，强制启用--single-transaction和--routines，同时单独导出mysql系统库：
mysqldump -u root -p --all-databases --single-transaction --routines --triggers --events > pre_upgrade_full.sql
mysqldump -u root -p mysql > mysql_system_pre.sql
第二步：对导出文件执行完整性校验——运行sha256sum pre_upgrade_full.sql，并将哈希值写入独立日志；再用mysql -e "source pre_upgrade_full.sql"尝试导入空实例，验证SQL语法无报错。
第三步：检查Yii1.1中是否使用了自定义用户表字段（如profile、activation_key）、是否重写了CWebUser类、是否在user表中存有非标准字段。这些字段【不会被Yii2自动识别】，必须人工记录字段名、类型、长度、默认值及业务含义，否则升级后将永久丢失。
Yii1.1到Yii2.0.55的数据库结构适配
方法一：保留原user表结构，仅新增Yii2必需字段
在现有user表中执行ALTER TABLE `user` ADD COLUMN `auth_key` VARCHAR(32) NULL, ADD COLUMN `password_reset_token` VARCHAR(255) NULL, ADD COLUMN `email_confirmed_at` INT(11) NULL;
注意：不要删除旧字段（如activation、lastvisit），Yii2不读取它们但业务代码可能仍依赖。
方法二：新建yii2_user表并双写同步（推荐用于生产环境）
创建新表结构后，编写一次性脚本，将Yii1.1 user表中id、username、email、password（需重哈希为bcrypt）、created_at、updated_at字段映射转入yii2_user；同时保留原表不动，所有登录逻辑先查新表，失败再fallback查旧表；待全量验证通过后再停用旧表。
方法三：用Yii2 Migration反向生成历史快照
在空Yii2项目中执行yii migrate/create init_from_yii1 —— 手动编辑生成的migration文件，在up()中写INSERT INTO yii2_user SELECT id, username, email, CONCAT('y$', SUBSTRING(password, 1, 59)) AS password_hash ... FROM yii1_user; 【密码字段必须重哈希，原md5/sha1不可直接复用】
配置与连接层的静默陷阱
第一步：禁用Yii1.1遗留的session表自动清理机制
检查index.php或main.php中是否设置了'autoCreateSessionTable'=>true，该选项在Yii2中不存在且会干扰session初始化；若存在，立即注释或删除整行。
第二步：替换数据库连接驱动
Yii1.1默认用PDO+MySQL扩展，Yii2.0.55要求PDO::ATTR_EMULATE_PREPARES设为false；在config/db.php中确认包含：'attributes' => [PDO::ATTR_EMULATE_PREPARES => false]，否则大批量INSERT可能因字符集转换丢失中文。
第三步：关闭Yii2的strict mode临时兼容
在db组件配置中加入'sqlMode' => 'NO_ENGINE_SUBSTITUTION'，避免升级初期因STRICT_TRANS_TABLES触发的插入截断错误；待全部表结构调整完毕、业务验证稳定后再移除此配置。
升级后必须执行的四步验证
① 运行php yii migrate/up --interactive=0，确认所有迁移执行成功，且yii_migration表中记录数与migrations/目录下文件数一致。
② 执行SELECT COUNT(*) FROM user与SELECT COUNT(*) FROM yii2_user（若双表并存），比对数值；再随机抽样5条记录，手动比对password_hash、email、auth_key字段是否可正常解密登录。
③ 启动应用，用curl -I http://localhost/login测试HTTP状态码是否为200；再提交一个含中文、特殊符号、超长字段的注册表单，检查数据库中对应记录是否完整落库、无截断、无乱码。
④ 查看runtime/logs/app.log，搜索关键词“Integrity constraint violation”、“Data too long”、“Unknown column”，任一出现即说明结构映射失败，必须回退并修正迁移脚本。
