设备标定页防呆为何失效：草稿与真值的错位
一、引子
设备标定界面上有个"运动前拦截"：你在轴上填个目标位置、点执行，如果超出限位，程序会弹框拦住、轴不动。本以为它是操作员的保险丝。
但有一种操作序列下，这个保险丝悄悄失灵了------不是不弹框那种"明显"的坏，而是弹错了框：本来该给一句清楚的"超限位、已拦下"，却换成控制器一句冷冰冰的"轴控异常"。轴其实根本没走过去，只是把"明确的提示"换成了"难懂的报错"。
更隐蔽的是另一种：有时它又误拦------明明能走的位置，被它拦下了。
问题的根子，不在拦截逻辑本身，而在于：它读错了"答案的来源"。
二、核心概念：同一份限位，系统里有"三处"
先理解一个事实：这台设备的轴限位，在系统里其实同时存在三份。
┌─────────────────────────────────────────┐
│ 你在标定界面上看到的"限位参数表" │ ← ① 界面草稿（可编辑副本）
│ 若干轴 × 正/负 限位，每轴两格 │
└─────────────────────────────────────────┘
│ 点"读取"重填 / 你手改
▼
┌─────────────────────────────────────────┐
│ 上位机程序里的"真值缓存"（全局单例） │ ← ② 上位机真值
│ 上电时从控制器读一次，全局业务都读它 │
└─────────────────────────────────────────┘
│ 点"写入"下发
▼
┌─────────────────────────────────────────┐
│ 控制器（PLC）里的寄存器 ------ 机器真正执行 │ ← ③ 真值（最终裁决者）
└─────────────────────────────────────────┘生活类比：把限位想成公司门禁的"可进时间段"。
- ① 界面草稿 = 你手里那张便签，写着你认为的时间；
- ② 上位机缓存 = 前台公告栏上贴的时间；
- ③ 控制器寄存器 = 门禁系统里真正生效的时间。
三个人看三处：保安（运动前拦截）如果去看便签而不是公告栏，就会出乱子。
关键事实：界面草稿只有标定页自己用；生产模式、以及其它所有业务，读的都是②上位机真值缓存；而机器真正卡你的是③控制器寄存器。
⚠️ 界面上改了格子的值不会自动生效，必须点"写入"才下发到控制器。这个"改了没写入"的中间态，就是后面所有问题的温床。
三、旧行为为什么错：判据源错位 → 静默失效
旧版的运动前拦截，是全仓库唯一一家去读①界面草稿的。其它地方都读②真值。于是：
情形 A：草稿改大、没点写入
- 你在便签上把"门高"写高了一点（格子改大），但公告栏和门禁都没动。
- 保安看便签：觉得能进 → 放行 → 真下发 → 门禁（控制器）按自己的老限位判 → 拒绝 + 报错。
- 结果：轴没真走过去，只是把"上位机给的明确提示（超限位、已拦下）"换成了"控制器的报错（轴控异常）"。操作员从一句人话，变成一句黑话。
情形 B：草稿改小、没点写入
- 便签写小了 → 保安看便签：觉得超了 → 误拦本来能走的位置。
一句话总结 ：拦截要拦的是"这台机器到底能不能走到 "，真值源只能是③控制器里已生效的限位。读①草稿，等于拿"你认为的值"去判断"机器实际允许的值"，天然脱钩。
这就叫静默失效------它不是崩，是"silently wrong"：表面上还在拦，判据却已经和机器脱钩。
四、技术点一：缓存会"饿死"------静默失效的另一种
②上位机真值缓存，只在两个时刻刷新：上电时 从控制器读一次、点写入后再读一次。
问题来了：如果上电时控制器没连上 （通信异常），缓存会一直停在"空值"。而代码里有个约定------限位全是空值，视为"还没读到 / 未标定"，于是运动前拦截整套让路（这是个刻意付的代价，宁可放过不可误拦）。
于是出现一条缝：启动后、还没点过"读取"之前，拦截等于没开。操作员以为有保护，其实没有。
修复（生动点） ：让"读取"按钮在重填格子的同时，顺带把真值缓存也刷一遍。
- 类比：以前公告栏只在开工和改门禁时更新；现在每次你刷门禁卡（点读取），顺手把公告栏也更新了。现场点一次，缓存就从空变实，拦截恢复。
- 这样即便启动那次没连上，操作员点一次"读取"即可自愈，不用重启。
设计上这一步还顺带把"两个取数口拆开、不得混用"落了地：读草稿的方法归标定页自用（写入侧自检要查的正是"即将写下去的值"），读真值的方法专门给运动前拦截用。两把钥匙开两把锁，互不串。
五、技术点二：静默失败------只弹框不记日志
轴限位只存在控制器里 ，上位机侧没有任何数值备份 （翻遍配置，只有一张控制器节点名表）。而旧的"写入限位"动作，一个字都不记日志。
生活类比：你改了公司门禁密码，却不在任何本子上留一笔"谁、何时、改成啥"。哪天门禁乱了，只能靠当时在场的人"凭记忆回忆"。
这暴露一个经典语法反模式------静默失败：
text
try {
执行轴动作();
} catch (异常) {
MessageBox.Show("出错了"); // 只弹框
// ❌ 没有任何 Log 记录
}catch 块里只弹了个框、吞掉了异常也不落日志。后果是：
- 事后查不出"谁、什么时候、把限位改成了什么"，还原只能靠现场人提前截图；
- 想看"某次轴移动失败"在不在日志里，完全取决于调用方有没有 catch + Log------同一天日志里能看到的几条"移动错误"，都是因为别处的调用链自己打了日志，而不是标定页这条链。
修复 ：在"写入限位"真正下发到控制器之前，落一条 Warning：
text
[WRN] 标定页写入轴限位：旧值 [每轴 正负限位] → 新值 [每轴 正负限位]为什么必须记在写之前 ：万一写完刷新缓存超时/失败，也能看到这次到底写了什么。这条日志，就是轴限位唯一的还原依据。
顺带一个工程经验：写给现场照着做的测试文档，控件名必须用界面原文（如"限位读取""限位设定""某轴正限位"），不能自造简写（B1/B2/"读取"）。现场人拿着"b1框"是懵的------文档是给人照做的，不是给人猜的。
六、验证思路（泛化）
改动不是拍脑袋，配了一份上机测试方案。像考卷分"必考题"和"加分题"，验证也分四组：
| 组 | 目的 | 关键操作（泛化） |
|---|---|---|
| 回归组 | 确认没破坏原有拦截 | 在某轴填超限位值 → 执行 → 应弹"轴限位警告"、轴不动 |
| 核心判定线 | 修的就是这条 | 在草稿表里把某轴限位改大但绝不点写入 → 去执行 → 仍应被拦 （旧版会放行）；反之改小 → 不应误拦 |
| 自愈组 | 堵"启动缓存空"的缝 | 重启后先不点读取就执行超限位 → 应不弹（缓存空让路）→ 点一次读取再执行 → 恢复弹框 |
| 未覆盖路径 | 补以前没测的 | 调宽轨道轴超限、同步轴开启时对端轴也查、写入侧三道闸（正负写反拒写 / 全空拒写 / 轴会停外面二次确认） |
⚠️ 最后必须恢复现场：测试会真改控制器里的限位，做完要把原值填回、点写入、再读回核对，并去日志确认最后一条"写入轴限位"的新值 = 原值。
七、小结
- 判定源要对准真值 ------凡是"这台机器到底能不能做"的判断，必须读已生效的真值，不能读"界面上的草稿"。读错源 = 静默失效。
- 缓存要主动刷新防饿死------只在上电/写入时刷新的缓存，遇启动连不上就会空转让路；把刷新挂到高频的"读取"动作上，点一次自愈。
- 改不可逆配置必须留痕 ------限位只存在控制器、上位机零备份；
catch只弹框不记日志是典型的静默失败，关键写操作前落一条"旧值→新值"日志，是唯一的还原依据。