03-三个典型案例复盘

8.3 三个典型案例复盘

本节摘要：用三个真实复盘把全书知识串起来：地址偏移的"读错值"、CRC 静默的"偶发断"、字序的"数据全乱"。每个案例按"现象→排查→根因→整改"完整走一遍。位置：8.1 有工具、8.2 有方法，本节用案例验收。

案例一：地址偏移——"读到的温度是隔壁那台的"

现象：新接 12 台温变，上位机显示温度与表头不符，但"看起来有规律"——第 N 台显示的是第 N-1 台的值。

排查：Poll 单读第 3 台（点表写 40011）→ 读到的是第 2 台的值。抓包看请求，地址填的偏移是 11，而 40011 对应偏移 10。

根因：程序把 PLC 习惯地址（40011）直接当报文偏移（应为 10），整体偏移 +1——第 1 台（40001→偏移 0）恰好没错，第 2 台起全部错位。

整改：所有地址统一按"点表偏移"录入并在代码注释里标清口径；批量校验脚本对比"面板值 vs 读回值"跑一遍全部 12 台。教训：地址口径（40001 vs 偏移 0）必须在代码里显式统一，靠人肉减 1 必出错。

案例二：偶发断流——"每天下午 3 点断两分钟"

现象：某车间 Modbus 总线每天下午 3 点左右断流约两分钟，其余时间正常。

排查：串口抓包发现断流期间从站无响应，且主站请求帧本身正常。怀疑干扰——下午 3 点正好是另一车间大功率电机换班启动的时间。示波器在断流时段抓 A/B 波形：出现大幅共模毛刺，差分信号被淹没。

根因：该段 RS-485 与动力电缆并行走了约 30 米，屏蔽层未接地，电机启动时地电位跳变耦合进总线。

整改：该段改走独立线槽（远离动力线）；屏蔽层单端可靠接地；波特率降一档留更多余量。整改后连续观察一周不再断流。教训：物理层干扰是"时间规律性故障"的头号嫌疑，先看布线再怀疑设备。

案例三：字序陷阱——"升级上位机后数据全乱"

现象：某能源项目把上位机从旧软件换到新平台后，电表功率数据全部异常（负值、天文数字），但电压电流正常。

排查：电压电流是单寄存器（无字序问题）正常；功率是 float32（跨两寄存器）全乱 → 锁字序。用面板值对照试解：面板 20.0kW，读到字节 00 00 A0 41，低字在前解出 20.0 —— 新平台默认"高字在前"。

根因：旧软件对该电表做了"低字在前"的私有适配，新平台用默认解析，字序不匹配。

整改：新平台里把该型号电表的字序配置改为"低字在前"；把"型号 → 字序"做成配置表，避免下次换软件再踩。教训：32 位数据的字序是设备私有特性，换软件/换网关/换解析库时第一件事就是核对字序配置。

三个案例的共同规律

回看三个案例，共同点惊人地一致：都不是协议坏了，而是实现口径不一致——地址口径（案例一）、物理实现（案例二）、数据口径（案例三）。Modbus 协议的简单让"口径问题"成为绝对主力：地址减不减 1、屏蔽接不接地、字序高字在前还是低字在前。调试 Modbus 的终极心法：默认怀疑口径，而不是怀疑协议与设备。

三案对照速览

三个案例的共性是"口径"：把三张沉淀清单写进接入流程，同类问题就不会再发生。

易错点清单

• 案例类问题按"设备坏了"处理：三个案例里换设备都解决不了问题，先按口径排查再动设备；
• 只修现象不修口径：案例二只降波特率不处理布线，干扰源还在，迟早复发；
• 不沉淀为文档：每个案例的根因与排查路径写进项目知识库，同类问题下次 10 分钟定位。

要点回顾：地址口径、物理实现、数据口径是三类高频根因；排查先怀疑口径；整改要治本（布线、配置表、文档沉淀）。三个案例复盘完，下一章收尾——聊聊"简单为何长寿"与协议选型。

复盘的四个层次

案例复盘要有深度，四个层次逐层问：现象层（发生了什么）；技术层（根因是什么技术细节）；流程层（为什么这个根因能漏过测试/验收——是点表没核对、布线没验收还是换软件没回归）；体系层（要补什么机制让同类问题不再发生——点表核对流程、布线验收标准、换软件的字序检查清单）。只复盘到技术层，同类问题换个马甲还会再来；复盘到体系层，才真正关上了门。

从案例到检查清单

三个案例各自沉淀一条检查清单：地址口径清单——新接入设备时核对"点表口径 vs 代码口径"（40001 vs 偏移 0），批量接入跑"面板值 vs 读回值"对照脚本；物理层清单——布线验收按第 5 章十条军规逐项检查（终端电阻、屏蔽接地、与动力线距离），雷雨季前专项复查；数据口径清单——接入新型号设备时做"已知值试解"确定字节序/字序/缩放，把结果写进设备配置档案。三条清单就是三个案例的"疫苗"，新项目照着打，就不容易再得同样的病。

知识沉淀的载体

复盘结论要沉淀到可复用的载体：排障速查表（现象 → 方向 → 处置，见 8.2）；设备配置档案（每类设备的地址口径、字节序、缩放、已知坑）；项目知识库（案例、工单、抓包归档）。三个载体分别在"现场应急、日常接入、长期沉淀"三个时间尺度上起作用——只复盘不沉淀，等于把学费交给经验，却不把经验变成资产。

易错点补充

• 复盘会开成追责会：复盘的目的是找机制漏洞不是找人背锅，追责会让下次没人敢暴露问题；
• 整改不验证：改完不观察一段时间确认不再复发，问题可能只是暂时隐藏；
• 案例不共享：A 车间踩过的坑 B 车间再踩一遍，案例要进共享知识库而不是躺在个人笔记里。

现场问答

问：怎么防止自己再踩地址口径的坑？ 把"点表口径 vs 代码口径"写进接入流程：新设备接入必须核对 40001 式地址与报文偏移的换算，批量接入跑"面板值 vs 读回值"对照脚本。

问：干扰类故障有没有预防手段？ 有：布线验收按军规清单逐项查（终端电阻、屏蔽单端接地、远离动力线），雷雨季前专项复查；设计阶段就按规范布线，比事后排障便宜一个数量级。

问：案例复盘应该沉淀到哪里？ 三处：排障速查表（现场应急用）、设备配置档案（日常接入用）、项目知识库（长期沉淀用）。只复盘不沉淀，等于把学费交给经验却不把经验变成资产。