- 记下当前客户、账套/API、用户和功能。
- 保留完整错误文字，不只截最后一行。
- 不清数据、不改库、不重复提交同一笔业务。
常见现象
登录与账套
登录后内容不对
先看首页顶部的用户、客户、账套/API 和地址。切换到正确账套后重新登录；不要在错误账套继续录入。
忘记密码或账号停用
普通用户走“忘记密码”或联系运维管理员重置；停用、归档和删除是不同状态，只有运维管理员能处理。
自动登录进了旧账套
在“我的”点“切换账套/API”，关闭不适合共用设备的自动登录，再选择正确账套和账号。
常见现象
功能、部门或候选不正确
APP 看不到某个功能
先刷新功能页；仍没有时由运维检查账号权限，再由实施员检查功能是否 Ready、是否绑定正确工作流程和使用范围。
部门不是想要的部门
部门由所绑工作流程决定，可有多个有效候选。实施员应修正流程配置，不能在 APP 或代码里写死一个部门。
下拉框没有目标货品/批号
先输入关键文字筛选；仍没有时检查客户货品范围、当前部门正结存和数据环境。自由文字不能保存成正式候选。
常见现象
扫码与手工输入
相机扫码没有反应
先允许相机权限；仍不可用时直接在同一输入框手工输入完整码。扫码与手输应走同一校验。
手输也提示格式错误
保留完整错误和原码，由实施员检查 PDA 正则、码类别、来源字段和手机目标字段，不要反复尝试相似码。
扫码找到错误对象
立即取消，不提交；核对账套、码类别和候选范围。识别或模糊匹配只能缩小候选，最终必须人工确认正式对象。
常见现象
提交失败、超时或重复
点提交后没有成功结果
不要把按钮点过当成功。保留当前页面，确认网络和顶部账套；看明确提示后再决定重试。
网络断开出现待补传
恢复网络后从首页“补传”。补传前不要新建同一笔业务，避免形成重复请求。
提示手机值与服务端解析值不一致
本次不会写入。交实施员检查数据环境、字段映射和正式 PDA 配置，不能通过改默认值掩盖。
常见现象
打印机、首次打印与补打
找不到蓝牙打印机
先到系统蓝牙完成配对，再在 APP 打印机页点“配对”或“+添加”。不要为了重试打印重复提交作业。
首次打印失败
业务提交是否成功与打印是否成功分开判断。记录已成功时走补打；记录未成功时先解决提交。
补打内容与原标签不同
停止补打并交实施员检查。补打必须使用同一 WorkID、码类别、模板和原标签快照。
常见现象
服务、授权与专业排障
显示离线或 API 不可达
运维管理员先在总览执行只读检查，核对地址、端口和服务状态；确需重启时先告知现场短暂中断。
授权过期或身份不符
运维查看授权状态；实施员按续期、换服务器或换账套身份的真实场景处理，不能改本地文件伪造授权。
功能 Blocked 但没有问题明细
这是诊断缺口，不应让实施员盲猜。保留当前 API、功能、时间和完整错误，进入实施员排障收集证据。