迁移文档模板：下次不再手忙脚乱

迁移做完最可惜的不是出了问题，而是问题怎么解决的没人记得。一份迁移文档不需要写得漂亮，关键是让半年后接手的人能照着复述整个过程。模板分四个部分就够。 一、清单：迁了什么 清单记录所有迁移对象：机器、域名、数据库、定时任务、证书、第三方回调，每项标注状态——已迁、待迁、不迁及原因。状态列比想象中有用：迁移中途被打断时，接手的人靠它知道从哪里继续。建议用表格，一行一项，再加一列验证方式，写明这项迁完用什么命令确认，比如 `curl -I https://你的域名`，返回 200 才算过关。清单模板可以长期复用，迁移之外，大版本升级、机房搬迁也用同一张表，只换列名。 二、时间线：什么时候发生 时间线按小时记关键节点：几点停写数据、几点开始同步、几点切解析、几点恢复业务。每个节点旁边留一列实际耗时，写实际值不写计划值——计划里一小时的同步实际跑了四小时，这个差距本身就是下次排期的依据。变更类动作记下操作人和复核人，事后有争议时对得上。 三、联系人：出问题找谁 迁移不只涉及技术：域名注册方、证书签发方、第三方接口的技术支持、公司内部的业务负责人，都要列进联系人表，附联系方式和响应时段。外部联系人提前确认他们在切换窗口的响应方式，别等出事才发现支持热线夜里没人接。切换窗口里遇到解析不生效这类问题，十分钟能不能找到人，直接决定停机时长。 四、复盘：哪里出了岔子 文档最后一节留给复盘：计划外的操作、实际耗时和预估的差距、下次要改的做法。写三五行就够，重点是落回清单，变成下一次的检查项。 迁移文档的价值到第二次迁移才兑现。这次多写十分钟，下次少慌两小时，这笔账怎么算都划算。