｜常见问题 & 排查

分为：扫码识别失败、扫完打不开 / 提示报错、提交报工失败、报工后数据异常、扫码枪（电脑 / 平板）问题五大类黑湖小工单

一、扫码识别失败（扫了没反应，识别不出二维码）

1. 手机摄像头 / 权限问题

• APP / 小程序没有相机权限；手机镜头脏、光线过暗、强光反光、二维码被遮挡褶皱磨损。 处理：系统设置开启相机权限；擦镜头；补光、调整扫码角度；二维码破损重新打印工单卡片。

1. 二维码打印模板错误

• 打印模板二维码字段选错，不是taskId任务码，扫完识别不了任务黑湖小工单。 处理：管理员后台检查打印模板，报工扫码要用任务 taskId 二维码，不要用工单 projectId、物料码。

1. 网络问题（车间 WiFi 弱）

• 扫码本身本地识别，但解析任务需要网络；无网会出现 “扫了转圈无结果”。 处理：切换 4G/5G；有离线缓存的版本，无网暂存，联网自动上传。

二、扫码成功，但提示报错、看不到报工界面

1. 提示：无权操作 / 找不到该任务

• 工单没有派工给当前登录账号；工单已完工、已关闭、已作废；账号归属车间 / 产线不匹配黑湖小工单。 管理员排查：工单状态是否 “进行中”；是否派工到该员工；账号所属车间班组是否正确。

1. 扫出来是工单详情，不是报工页

• 打印的是工单码 (projectId)，不是工序任务码 (taskId)。报工必须打印任务二维码。 处理：修改打印模板，输出任务 (taskId) 二维码。

1. 登录企业选错（多工厂）

• 账号下多个工厂组织，登录到别的工厂，扫码任务不属于当前工厂。 切换正确企业组织后再扫码。

三、录入数量后提交报工失败

1. 数量校验拦截

• 良品 + 不良品＞本工序剩余待报数量；工序设置工序流转顺序，上道工序未完成，禁止跳工序报工。 核对可报剩余数量；先完成前道工序再报工

1. 强制质检配置

• 工序开启 “报工后必须质检”，提交后不是直接完工，流转到质检环节，属于正常现象。

1. 网络超时提交转圈车间信号差，提交请求发不出去；APP 版本老旧。 更新 APP；切换网络；离线模式等待网络恢复自动同步。

四、报工提交成功，但后台数据异常

1. 报工找不到记录

• 离线报工，网络没恢复，数据还在本地，未同步云端；账号登录错企业。 恢复网络等待同步；核对登录工厂。

1. 报工数量多记 / 少记、归属工序不对

• 扫错任务码；多人报工混淆；打印模板绑定错误工序。 核对扫码的任务卡片；后台查看报工记录的任务 ID。

1. 报工后工单进度不变

• 只是部分工序报工，不是全部工序；部分工序还有待报工数量。

1. 需要修改 / 删除已经报工记录

• 未审核：手机 / 电脑端可直接编辑删除；

• 已审核：不能直接删，管理员驳回后修改。

五、电脑 / 平板外接扫码枪报工常见故障

1. 扫码枪扫完无任何输出 页面不要选中输入框，点击空白处；扫码枪设置为键盘模式，输出带回车后缀黑湖小工单。

2. 提示 “无法识别，请确认重试” 记事本测试扫码输出内容；确认输出是 taskId 格式；电脑输入法切英文；浏览器用 Chrome/Safari，不要用兼容模式浏览器黑湖小工单。

六、快速现场排查步骤（工人端）

1. 确认账号登录正确、企业选对；APP / 小程序是最新版2. 确认工单卡片二维码完好，不是工单码，是任务码3. 确认工单状态是进行中，已经派工给自己4. 确认手机相机权限、光线、网络5. 扫码后看提示，按提示核对数量、工序前置条件

七、管理员后台自查清单

1. 打印模板：二维码字段 = taskId（任务 ID）2. 工单状态：进行中，已派工给对应员工3. 工序配置：是否开启工序顺序校验、强制质检4. 账号权限：员工归属车间、班组；手机端权限已开启5. 查看【报工记录】，核对任务 ID、操作人、时间、数量