版本更新时的数据兼容处理

陆大王

版本更新最怕的不是新功能有 bug，而是老玩家的数据出问题：装备消失、等级回退、任务进度重置。这篇讲更新时怎么做数据兼容，把风险降到最低。

一、更新前必须全量备份

数据库、脚本、配置三样都要备份，备份文件带日期和版本号。备份不是走流程，出问题时它就是唯一的退路。备份完做一次恢复测试，确认备份本身可用。

二、理清哪些数据会变

新增字段、修改字段类型、调整表结构，这三类改动最容易出问题。更新前把涉及的表列出来，逐张确认老数据能否兼容。新增字段要给默认值，不能让老数据变成空值。

三、先在小数据上试

把正式库复制一份到测试环境，在测试库上跑更新流程。确认老角色能正常登录、装备还在、任务进度正确，再动正式库。这一步能发现大部分兼容问题。

四、字段变更要写迁移脚本

字段改名或者拆分，需要写迁移脚本把老数据搬过去。迁移脚本要能重复执行，中途失败可以重跑。一次性脚本出问题，数据可能就回不来了。

五、注意物品与技能编号

版本更新经常调整物品和技能编号。编号变了但玩家身上的物品没跟着改，就会出现装备变成别的东西，或者直接消失。更新前核对编号变化，必要时写映射表。

六、任务与变量兼容

任务进度、活动记录都存在变量里。变量编号或者含义变了，老玩家的进度就会错乱。更新时保留旧变量，新增变量从新编号开始，不要复用旧编号。

七、灰度更新

先更新一部分区，观察一天，确认没有数据异常再全量更新。出问题时影响范围可控，回滚也快。全量更新出问题，等于所有区一起遭殃。

八、回滚方案

准备回滚步骤：停服、还原数据库、还原脚本和配置、启动验证。回滚要能在半小时内完成。回滚之后玩家的进度会退回到备份时间点，提前想好补偿方案。

九、更新后的核对

更新完成随机抽几个老角色，检查等级、装备、元宝、任务进度是否正常。再走一遍核心玩法，确认没有功能失效。核对清单固定下来，每次更新都照着做。

十、选好更新窗口

更新尽量安排在人数最少的时段，通常在凌晨。更新前发公告，给玩家留出下线时间。更新时不要同时改多项内容，一次只做一类变更，出问题好定位。

十一、兼容问题优先于新功能

更新时如果发现老数据有兼容问题，先解决兼容，再考虑新功能。新功能可以晚一天上线，数据错了却可能永久损失。这个优先级不能颠倒，尤其是涉及装备和等级的时候。