网站迁移要准备的记录,核心是让接手的人不用问也能独立完成上线、回滚和后续维护。建议从交付结果倒推:先确定迁移后必须能正常访问、能改内容、能查数据、能恢复旧站,再逐项准备账号权限、环境配置、数据备份、域名解析、任务分工和验收记录。记录不全时,最典型的后果是迁移后图片打不开、表单收不到提交,或者出问题无法回退。
多人协作时,记录不是越厚越好,而是对应四个可验证的结果:
这四项决定了需要哪些记录,而不是先列一堆文档名称再想用途。
迁移前应整理一份权限清单,至少包含:域名注册商账号、DNS 解析权限、服务器或主机面板账号、数据库账号、网站后台管理员账号、对象存储或 CDN 账号、统计与站长平台账号。每项记录要写清账号归属人、当前密码保管方式、是否开启二次验证、谁能授权变更。
适用条件是多人协作或外包交接。判断结果很简单:如果迁移当天需要重置密码才能登录,说明记录不完整。注意不要把密码明文写在普通聊天记录里,应使用团队约定的密码管理方式,并记录授权流程。
网站迁移不只是复制文件。需要记录运行环境,例如服务器操作系统版本、Web 服务器类型、程序语言版本、数据库类型与版本、必要的扩展组件、伪静态规则、定时任务、目录权限。以常见 伪静态 配置为例,如果旧站依赖 URL 重写,新环境没同步规则,栏目页就可能全部 404。
还要记录域名解析:A 记录、CNAME 记录、MX 记录分别指向哪里,TTL 设为多少。TTL 较短时回退更快,但解析变更生效也受各地递归 DNS 缓存影响,不能承诺固定生效时间。迁移前把当前解析截图或导出为文字记录,迁移后逐条比对。
备份记录要写清备份时间、备份方式、存放位置、校验方式和保留期限。至少覆盖:
检查项是:在新环境导入后,随机打开一个含图片的文章、提交一次测试表单、查看一条历史数据。如果图片缺失,通常是附件目录没同步;如果表单收不到,可能是邮件配置或接口地址没改。这里要区分“可能原因”和“已经定位的原因”,逐项排查后再下结论。
从交付结果倒推,迁移任务可以拆成:备份旧站、准备新环境、导入数据、修改配置、解析切换、功能测试、旧站保留、回滚演练。每项任务写清负责人、开始与完成时间、依赖条件、验收人。多人协作时,最容易返工的是“以为对方已经改了配置”。
验收记录建议用一张清单,逐项标记通过或失败,例如:首页、栏目页、详情页、搜索页、表单页、移动端页面、后台登录、图片显示、HTTPS 证书、旧链接跳转。失败项要写明现象、影响范围和下一步处理人。假设一个例子:迁移后发现产品详情页正常,但产品列表分页 404,记录中应写明“列表分页规则未同步”,而不是只写“迁移有问题”。
先按上面五类做一份空白记录表,把已知信息填进去,缺的项标出负责人和截止时间。然后在正式切换前,用测试域名或本地环境完整走一遍导入与验收流程,确认回滚路径可用,再安排正式解析切换。