物联网老平台没人敢动，怎么接手

我们最近接手的一个项目，客户的原话是："系统能跑，但没人敢动。"

那是一套车联网电池远程监控大数据平台，已经运行了好几年。原负责人离职后，留下的是 SVN 归档、服务器备份和几份文档。代码横跨 C++ 网关、Java 解析服务、Scala Spark 作业和 Vue 前端，依赖版本很老；配置文件里混着生产地址和明文账号；更麻烦的是，线上跑着的程序和手里的源码对不上。

这种情况在物联网项目里并不少见。设备平台的链路长、组件多，一个人走了，往往一大块就成了黑箱。下面说说我们接手这类系统的顺序，也是我们在 物联网平台接手维护 里的基本做法。

第一件事：别急着改代码

接手老系统最常见的错误，是一上来就修 Bug。改了一处，另一处莫名其妙坏了，因为谁也不知道这段代码还被谁调用。

我们的第一步永远是只读归档：原始交接资料原封不动保存一份，另建干净的维护目录，之后所有改动都在新目录进行。这样任何时候都能回头对照原始状态。

接手前要准备哪些资料

能拿到的越多越好，但不用等齐了才开始：

• 代码仓库或归档（SVN、Git、压缩包都行）
• 服务器备份、部署脚本、配置文件
• 协议文档、接口文档、数据库结构
• 线上还在运行的服务、版本和服务器清单
• 近期最急的问题和业务计划

最后一条很重要。客户是想先稳住、修几个具体问题，还是准备重构或上云，决定了梳理要做到多细。

按数据流还原链路

物联网平台的结构，顺着数据走一遍最清楚。那个车联网平台，我们还原出来的链路是：

终端 → 接入网关 → Kafka 原始主题 → 协议转 JSON / 结构体解析 / 告警解析 → MySQL、HBase / Phoenix、云端数据总线 → Spark 离线预处理 → 监控平台

一共 13 个子项目。每个子项目标注职责、技术栈、依赖版本，以及对应交接资料里的哪一条。做完这一步，团队第一次能在一张图上看清整个系统。

源码和线上版本逐个比对

"源码和线上对不上"是老系统最危险的地方。你以为在改线上的逻辑，其实改的是一份早就过时的代码。

我们把源码和线上运行包逐个比对。那个项目的结果是：源码类覆盖 166 / 168，视图覆盖 61 / 67。差的那几项全部登记，后面改到相关模块时会特别小心。

凭据脱敏，默认不连生产

老系统的配置里经常能看到明文数据库密码、生产服务器地址。交接过程中这些东西会被拷来拷去，风险很大。

我们会把所有明文凭据替换为占位符或环境变量。本地验证环境默认不连接任何生产系统，需要联调真实环境时，由客户明确授权并提供配置。安全相关的基本做法，可以参考 物联网系统安全设计怎么落地。

建一个能一键拉起的本地环境

梳理清楚之后，下一步是让系统能在本地跑起来。我们用统一的 Makefile 和 Docker Compose 拉起 MySQL、Kafka、HBase、写入服务和新旧两版界面，另外写了一个设备模拟器，批量生成模拟车辆的实时数据和告警，从界面上能回看整条链路。

有了这个环境，后面每一次修改都能先在本地验证，再考虑上线。这是"敢动"和"不敢动"的分界线。

缺什么就写什么，不靠猜

梳理过程中一定会发现缺口：某个依赖找不到了，某个外部服务的配置没留下，某段构建脚本跑不通。这些我们不靠猜测补齐，而是如实写成缺口清单交给客户，由客户去找原供应商或内部同事确认。

接手之后：维护、升级还是迁移

梳理完成后，客户手里会有链路图、比对报告、本地环境和缺口清单。这时候再决定下一步就有依据了：

• 系统整体稳定，只是缺人维护：继续维护，按问题逐个修复
• 部分模块风险高或依赖过时：局部升级，先换最危险的部分
• 业务要大改或要上云：逐步迁移，新旧并行一段时间

另一种常见情况是从第三方 IoT 平台迁回自有平台。我们做的 航标远程监测平台 一期借助第三方平台接入遥测，同时把历史数据、用户分组和导出沉淀到自建服务，为以后整体迁移留好路径，迁移时业务不用停。

如果你在选新的合作团队，也可以看看 深圳物联网APP开发外包避坑指南，很多接手难题其实在立项和合同阶段就能避免。

常见问题

只想修几个紧急问题，也要先做完整梳理吗？

不一定要全量梳理，但至少要把相关模块的链路和构建环境搭起来，确认修改能在本地验证。否则很容易修一个问题、引出另一个问题。

接手会影响线上运行吗？

梳理和本地验证阶段不连接生产环境，用模拟器造数验证链路。真实环境的联调需要客户授权后再进行。

原来的技术栈很老，你们能接吗？

C++ 网关、Java / Go 服务、Kafka、HBase、Spark、MySQL、Vue 这类常见组件都接过。遇到不熟悉的组件，会在评估阶段如实说明。

接手前需要先签长期维护合同吗？

不需要。可以先做一个梳理阶段，交付链路图、比对报告和缺口清单，你再决定后续怎么合作。有类似情况可以直接 联系我们，说明手上的资料和最急的问题。