先分类，再排查
收银故障分四类，处理路径完全不同：
| 现象 | 大概率原因 | 处理 |
|---|---|---|
| 收不到识别结果 | 相机掉线 / 识别服务未启动 | 查设备在线状态与进程 |
| 识别结果错 | 商品不在库 / 光照变化 / 工位遮挡 | 查识别日志与图片留样 |
| 计价错 | 价格同步延迟 / 称重读数漂移 | 对价格版本号、校秤 |
| 上传失败 | 网络中断 / 服务端限流 | 查本地队列积压量 |
三个必备的留样
- 识别图片留样：每笔识别存一张缩略图，否则无法复盘「为什么认错」
- 本地队列：断网期间的数据必须落盘排队，不能丢
- 版本号：模型版本 + 价格版本 + 库版本，三者都要能在门店端查到
排查顺序（别跳步）
- 设备在不在线
- 识别服务活着吗
- 这笔的留样图片长什么样
- 库里有这个商品吗
- 价格版本对不对
跳过第 3 步直接怀疑算法，是最浪费时间的排查方式。