新闻资讯

记录优翰动态,分享技术实践。

车间App弱网离线数据不丢:本地队列与回传排查指南

车间里手机、PDA、工控机常常处在信号死角,工人录完工序点击提交后,界面显示成功,后台却查不到这条记录;或者同一道工序出现两条重复数据、时间顺序颠倒。这类问题多出在三个环节:本地没有可靠的队列、服务端合并规则不清、回传后缺少核对。

下面按排查顺序展开,先定位数据卡在哪一段,再决定改队列、改合并逻辑还是补回传核对。涉及具体产线、工序和第三方系统的场景,可以参考我们做过的制造业数字化项目案例。

现象复述:提交成功但数据对不上,问题通常在哪

车间弱网问题的典型表现不是报错,而是「看起来成功了」。工人的操作习惯是点完就走,不会盯着页面上报,所以问题往往在班次汇总或对账时才暴露。

常见现象可以归成三类:一是漏记,某些工序记录在后台完全找不到;二是重记,同一工序出现多条相同或相近的记录;三是乱序,后发生的工序先落库,导致流转状态卡住。三类现象背后的原因不同,排查入口也不同。

排查方向一:本地队列是否真的持久化了

离线时先把数据写入本地,再等网络恢复后批量上传,这是通用做法。但「本地」两个字经常被处理成内存里的一个数组,App 被系统回收或进程崩溃,队列就没了。

需要确认队列是否落在持久化存储上,并且写入时机在什么时候。建议在用户点击提交后立即落盘,再把「已入队」反馈给界面,而不是等网络请求返回。落盘成功和上传成功要分开提示,否则工人无法判断这条数据是否安全。

排查时重点看三件事:

  • 队列存储是否可持久化(如数据库或文件),而不是仅存在内存变量里;
  • 每条记录是否有稳定且不重复的本地标识,用来在上传时去重;
  • 是否记录入队时间、重试次数和最后错误原因,便于现场定位。

如果队列设计本身还没定型,可以先从记录结构和写入时机入手,具体的结构评估方式在服务范围与交付流程中有说明,便于在需求阶段就把离线场景纳入验收范围。

排查方向二:上传策略与重试是否可控

队列里攒了几十条数据,网络一恢复就并发上传,容易出现两种问题:服务端瞬时压力大,以及部分请求重复提交。尤其是弱网下超时时间较长,客户端判超时后重试,服务端其实已经处理成功。

通用做法是按顺序串行或小批量上传,配合可退避的重试间隔。重试必须有上限,超过上限转入待人工处理的旁路,而不是无限循环。上传结果要区分「成功」「可重试失败」「不可重试失败」三类,业务校验不通过属于第三类,重试没有意义。

另一处容易忽略的是重复提交保护。客户端上传时携带本地唯一标识,服务端以这个标识做幂等判断;如果跨设备、跨班次,还需要配合业务单号。判断标准是:同一终端的同一条记录,重复上传任意次,落库结果应当一致。同类集成场景的处理差异,可以对照互联网与软件行业项目案例里的做法取舍。

排查方向三:冲突合并规则是否明确到字段

离线期间多人或多端对同一条工序记录做了修改,回传时必然产生冲突。冲突不一定是技术问题,更多是业务规则没定清楚:以谁为准、以什么时间为准、要不要留痕。

建议按数据性质分三类处理:只增不改的记录,用唯一标识去重即可;带状态的工序流转,按业务状态机判断哪一方合理,而不是简单用时间戳覆盖;文本和参数类字段,可以保留最后一次修改并记录变更痕迹。设备时间不可靠时,不要盲信终端时间,通常以服务端接收时间为归档依据,终端时间仅作参考。

合并规则要写下来,并且能被验收:

  • 每类业务数据的冲突判定条件是什么;
  • 冲突时保留哪一份、覆盖哪一份,是否有历史记录;
  • 冲突无法自动判定时,进入哪个人工处理入口。

如果合并规则会涉及 OA 审批或 ERP 工单回写,还需要确认权限边界,避免离线补传的记录绕过审批。国产 OA 的集成通常需要梳理组织与权限体系,具体以接口文档和现场环境为准。

排查方向四:回传后的核对机制是否闭环

上传成功不等于业务数据正确。服务端需要有一份「已接收记录」的索引,客户端上传后按批次拉取确认结果,核对数量与关键字段是否一致。发现差异的,补传或标记异常。

同时,服务端要有可查询的上传日志,至少包括终端标识、本地标识、接收时间和处理结果。现场报「数据丢了」时,先用本地标识反查是没上传、上传失败还是合并时被覆盖,避免把问题都归到网络。

逐项排查顺序

  1. 确认工人操作时间点与信号情况,复现时记录是否进入离线状态;
  2. 检查终端本地队列是否有这条记录,没有则问题在采集与落盘环节;
  3. 有记录但未上传,看上传策略、重试次数与错误分类;
  4. 上传成功但业务表缺失,检查服务端幂等判断和写入事务;
  5. 记录存在但字段或状态不对,回到冲突合并规则逐字段比对;
  6. 仍无法定位时,用回传日志按本地标识串联全链路,确认在哪一跳断掉。

预防措施:设计与验收阶段该做的事

这类问题靠上线后补救成本很高,建议在方案阶段就把离线作为独立场景写入需求,演示断网、切网、杀进程、长时间离线四类用例,并进入验收。

计划在产线推广终端采集时,可参考物流与供应链项目案例中对弱网区域作业的设计思路,但要按自身工序和网络条件做调整。整体交付与运维交接按软件定制开发与系统集成服务的流程推进,可在同类项目案例中查看交付边界。

自查清单

  • 离线记录是否写入持久化存储,杀进程后能否恢复;
  • 每条记录是否有本地唯一标识,服务端是否据此幂等;
  • 重试是否有次数上限与退避策略,失败是否可见;
  • 冲突合并规则是否覆盖到字段级,并可以演示;
  • 服务端是否有上传日志,能按本地标识反查;
  • 验收用例是否包含断网、切网、杀进程、长时间离线;
  • 回传核对是否按批次比对数量与关键字段;
  • 无法自动处理的冲突是否有明确的人工入口。

常见问题

离线数据只存本地够不够?不够。本地只解决「不立刻丢」,还需要上传策略、幂等和回传核对配合,否则容易出现重复或漏单。

终端时间不准怎么办?不要把终端时间作为唯一判定依据,冲突判定通常结合业务状态与服务端接收时间,终端时间只作参考。

队列很久没清空怎么处理?先看是按错误类型阻塞还是持续重试,再检查是否有单条坏数据堵住整个队列,建议支持按记录单独处理。

如果正在规划车间数据采集终端,需要把离线与回传要求写进技术方案,可以通过联系我们做一次场景梳理。

@2016-2026 上海优翰信息科技有限公司 版权所有
沪ICP备16045124-1号
沪公网安备 31011202014563号

沪公网安备 31011202014563号