2. 矿山物联网数据链路全景梳理

要排查掉线和断点续传问题，第一步不是急着看日志，而是先把数据从产生到消费的整条链路画清楚。矿山物联网的数据链路通常跨越井下半封闭空间、工业环网和地面云平台三个物理域，任何一段的异常都可能表现为“平台看不到数据”，但根因可能完全不同。本节按数据实际流经的顺序，把链路拆成五个环节，并明确每个环节的掉线风险点和断点续传的作用位置。

五个环节与数据形态变化

链路可以概括为：井下传感器 → 采集网关（边缘节点）→ 工业环网/传输通道 → 平台接入与存储 → 业务应用。数据在每个环节的形态并不相同，这一点对排障非常关键。

• 传感器层：输出的是原始测量值，常见接口有 RS-485/Modbus RTU、4-20mA 模拟量、CAN 以及部分 LoRa/NB-IoT 无线节点。数据带时间戳（部分低端设备不带，需要网关补打），采样周期从 1 秒到 60 秒不等。
• 网关层：负责协议转换、数据清洗、本地缓存和上报。它把 Modbus 寄存器地址映射为有业务含义的测点编码（如 CH4_01、FAN_SPEED_03），并决定是否启用断点续传。
• 环网/传输层：井下交换机组成冗余环网，经光缆上联至井口，再通过专线或 4G/5G 到达地面机房。这一层掉线往往表现为整片区域同时失联。
• 平台层：接入服务做鉴权与解包，消息队列缓冲，时序数据库落盘。平台侧的限流、Topic 权限错误也会造成“数据到了但没入库”。
• 应用层：组态画面、报警推送、报表。应用层掉线多为订阅关系或查询条件问题，通常不影响数据本身。

掉线可能发生的环节与判断特征

把链路画清楚之后，掉线定位就有了“分段排除”的依据。不同环节的掉线在平台侧留下的痕迹差别很大，可以据此快速缩小范围。

例如，某矿反馈“三采区瓦斯测点全部不显示”，而其他采区正常。按上表判断，问题大概率在网关出口或该区域上联段，而不是单个传感器。此时先查该网关的心跳是否还在，再看环网对应端口的光功率，通常能在几分钟内定位。

断点续传为什么放在网关

断点续传的本质是“链路中断期间数据不丢，恢复后按序补传”。它最适合放在采集网关，原因有三点：第一，网关是数据离开井下前的最后可控节点，能覆盖传感器到网关、网关到平台两段中断；第二，网关本地有存储介质，可以缓存数小时到数天的数据；第三，网关掌握测点编码和原始时间戳，补传时能保证数据可被平台正确归位。

典型实现方式是：网关为每条上报数据分配一个自增序号或使用时间戳作为断点标识，正常上报时记录“已确认序号”；链路中断后数据写入本地环形缓冲区；恢复连接后先与平台比对最后确认序号，从断点处按序补传，平台侧做幂等去重。这里的关键参数是缓存容量和补传速率：若单网关 200 个测点、每 5 秒一采，每小时约 14.4 万条记录，按每条 100 字节估算约 14 MB/小时，缓存 24 小时需预留约 350 MB 空间，补传速率则要避免恢复瞬间把环网打满。

排障时的链路分段方法

实际排障建议按“从平台往井下倒查”的顺序：先在平台确认最后一条数据的测点范围和时间，判断是单点、单网关还是区域性问题；再登录网关查看心跳、缓存队列长度和最近上报返回码；最后检查环网端口状态与传感器总线。这个顺序的好处是每一步都能把问题范围缩小一个域，避免一上来就下井查线。

需要强调的是，链路全景图不是一次画完就结束的文档。新增网关、调整环网拓扑、平台更换接入地址后，都应同步更新链路图和测点映射表，否则后续排障会因“图与实际不符”而走弯路。