最近在做一个设备监控系统的重构,代码里一个通信模块的设计让我印象挺深——三网口合一,把有线、Wi-Fi、4G/5G三种网络出口整合到一个调度层里统一管理。这个设计在实际项目里不算特别常见,多数系统是双网口或者单网口方案居多,所以这块代码值得单独拆出来聊聊。
先说下这套监控系统的大背景:它服务的是一批分布在不同物理位置的边缘设备,每台设备需要向中心平台上报状态数据、接收远程指令,同时还要支持运维人员通过本地调试口做现场维护。设备本身有三条网络通路可选,但历史上是各管各的,导致的问题是:链路切换要人工介入、故障时无法自动补救、网络状态没有统一视图。这次重构的目标很明确——把三条网口收编到一个通信管理模块下,让上层应用无感知底层走的是哪条路。
1. 代码结构拆解:一个“小而精”的分层骨架
整个工程不是那种动辄几十个模块的巨型项目,更接近“小而精”的路子。从目录结构上看,核心代码分成几块:app 业务层、core 核心调度逻辑、drivers 硬件驱动适配、protocol 协议解析、utils 公共工具。这种分层的思路不新鲜,但在监控系统这种对稳定性要求高的场景里,分层清晰与否直接影响排查故障的效率。
code复制project/
├── app/
│ ├── monitor/ # 监控业务主逻辑
│ ├── config/ # 配置文件解析与管理
│ └── tasks/ # 周期任务、上报任务、指令任务
├── core/
│ ├── comm/ # 通信调度核心(重点)
│ ├── event/ # 事件总线
│ └── storage/ # 本地缓存与持久化
├── drivers/
│ ├── eth/ # 有线网口驱动封装
│ ├── wifi/ # Wi-Fi 驱动封装
│ └── modem/ # 4G/5G 模组驱动封装
├── protocol/
│ ├── parser/ # 各厂商协议解析
│ └── framer/ # 报文封装/解帧
└── utils/
├── logger/ # 分级日志
├── watchdog/ # 看门狗
└── net/ # 网络工具集
1.1 业务层与通信层之间的“隔离带”
app/monitor 里跑的是业务逻辑,比如定时采集设备温度、电压、运行状态,组织成上报报文。关键在于,业务层完全不直接调用 eth_send() 或 wifi_send() 这类驱动函数,而是通过 core/comm 暴露出来的统一接口 comm_send(data, priority) 来发送数据。这个设计我在项目里见过不少失败的版本——业务代码里到处都是 if (wifi_connected) { ... } else if (eth_connected) { ... }——结果就是每加一种链路,业务层就得跟着改一遍,非常被动。
在这套系统里,core/comm 是唯一的通信入口,它负责做三件事:选路、发送、反馈。选路是核心,发送是执行,反馈是把结果通知回调用方。业务层不需要关心当前用的是有线还是蜂窝网络,只需要告诉通信层“我要发一段数据,优先级是普通/紧急”,剩下的交给调度模块。
