2026/11/14 2:17:36
接手一套跑了五年的政务门户,先做了三张交接表
接手一套跑了五年的政务门户,先做了三张交接表
11 月 13 日,两条新闻刷在一起:一条讲腾讯二十八岁这一年的组织调整,一条讲英伟达员工请愿让创始人复职。人事上的事我们管不着,但作为做外包和维护的人,我对“人一走、代码没人接”这件事特别敏感。
上个月我们刚接了一套跑了五年的政务门户,原团队解散,甲方手上只剩一个压缩包和三句口头说明。这篇记一下我们是怎么接的,以及那三张交接表。

## 一、刚接手时的状态
具体一点:
- 代码库只有一个分支,最后一次提交是八个月前;
- 服务器上的配置文件与仓库里的对不上,生产库连接串是直接改在机器上的;
- 有七个定时任务,其中三个的代码在仓库里根本找不到;
- 域名证书还有三十一天到期,没人知道续期账号是谁的;
- 数据库备份每天在跑,但从来没人做过恢复验证。
最后一条最让我不安。备份能跑不代表能恢复,这是两件事。
## 二、第一张表:系统资产表
不是写文档,是先把“东西在哪”弄清楚。每一行一个资源,字段就六个:类型、地址、用途、账号归属、责任人、到期时间。
扫下来发现:
- 四个域名,其中一个指向的服务器已经下线半年;
- 两个云账号,一个用个人手机号注册,验证码在离职同事手里;
- 一个短信通道的密钥写在代码里,每月还在扣费;
- 一个对外接口的授权码早过期,但因为没人调用,一直没发现。
这张表总共四十二行,花了两天。价值在后面两个月里不断体现:证书到期前一周自动提醒、停掉了一个每月白花钱的短信套餐、把云账号主体变更成了单位。
## 三、第二张表:数据与任务表
这张表回答的是“什么东西在自动跑”。
我们把服务器上所有 cron、计划任务、消息队列消费者列出来,逐个对应到代码。一共十九个,对上了十二个,剩下七个:
- 三个是从仓库里删掉但机器上没清理的旧任务;
- 两个是运维手写的脚本,存在某个人的家目录里;
- 一个是从正式库往报表库同步数据的作业;
- 最后一个最离谱:每天凌晨两点把某个目录的文件传到另一台机器,没人知道是干什么的。
我们先全部改成只记录不执行,观察一周。结果那个“不知道干什么的”任务停掉后,第四天有市民反馈查不到办件进度。原来它负责同步一个结果文件。
这就是交接里最难的部分:没人知道的东西,往往是最关键的。
## 四、第三张表:运维口径表
这张表写的是“出事时怎么办”,而不是“系统怎么设计的”。
内容包括:
- 部署步骤(其实是手动传文件 + 重启服务,我把它写成脚本并备份了旧版本);
- 回滚方式(原来没有,现在保留最近三个版本的包);
- 备份策略和一次真实的恢复演练记录;
- 常见故障的处理办法,比如磁盘满了、证书过期、任务卡死;
- 告警联系人,以及甲方内部谁知道业务规则。
恢复演练是甲方最在意的一项。我们拿测试环境完整恢复了一次生产备份,发现备份文件里漏了两个表,原因是备份脚本写了排除参数。如果不演练,这个问题要到真出事那天才会暴露。
## 五、两周之后的收获
摸清系统花了两周,交付了四十多页文档。真正的回报在后面:
- 上线第三周,证书到期告警自动发出,提前续了;
- 第五周报表库同步任务挂了,我们看日志十分钟定位到磁盘满,而不是像以前那样重启了事;
- 甲方后续要做等保整改,直接拿这三张表当底稿,省了一大块调研时间。
## 六、代价与建议
说点实话:
- 交接期间基本不产生新功能,甲方会觉得“你们什么都没做”,需要提前沟通好预期;
- 有些东西靠看代码是摸不出来的,必须找到原来对接的业务人员聊,这比读代码慢得多;
- 文档写完没人维护会迅速过期,我们把三张表放进了每月的运维例会议程。
如果你也要接手一套老系统,我的建议很简单:先别急着改代码,先把“东西在哪、什么在跑、出事怎么办”这三件事写下来。写不出来的部分,就是风险所在。
## 最后
系统交接的验收标准,不是双方签了字,而是新人能不能在凌晨两点被叫起来、看着文档把问题处理完。
我们后来在合同里加了一条:交接完成后,原团队必须配合一次真实的故障演练。签得再漂亮,不如跑一次。




