常见问题
约 1187 字大约 4 分钟
物联卡常见问题故障排查通道同步
2026-08-01
这里汇总物联卡使用过程中的常见问题与排查方法。排查顺序建议遵循「先通道、再数据、后操作」:先确认通道同步链路正常,再核对卡与资费数据,最后检查操作任务的执行结果。
通道同步失败 / 轮询报错
现象:通道轮询错误页面出现失败记录,或手动同步报错。
排查步骤:
- 核对凭据是否正确:进入通道管理,确认通道凭据已配置且填写正确(凭据只显示是否已配置及掩码,需重新填写才能修改);
- 确认通道已启用:停用的通道不允许向上游发起请求,请确认通道状态为启用;
- 确认上游地址可达:通道接入地址应能从平台访问,检查地址是否正确、上游服务是否正常;
- 查看轮询错误详情:到 轮询错误 页面查看失败原因,判断是凭据问题、地址不通还是上游接口异常,修正后重新同步。
卡状态或用量长时间不更新
现象:卡的在线状态、套餐或用量数据长时间停留在旧值。
排查步骤:
- 检查通道是否开启轮询:通道的「是否轮询」开启后,平台才会按周期向上游同步卡状态、套餐与用量;未开启时只能依赖手动同步;
- 查看轮询错误:轮询开启但仍不更新,到 轮询错误 页面确认同步链路是否有失败记录;
- 查看任务日志:确认相关同步任务是否执行成功,失败原因见 任务日志;
- 仍异常时,可在卡列表对单卡执行「同步状态 / 同步用量」手动触发一次,观察是否恢复。
导入失败
现象:批量导入报错,或任务结果中出现失败行。
排查步骤:
- 核对模板版本与表头:导入只接受正式 Excel 模板,请下载最新模板,确认表头与模板一致;
- 核对 ICCID 格式:ICCID 必须为 18–22 位数字,非数字、位数不符或为空都会导致该行失败;
- 检查文件内重复:同一文件内 ICCID 不允许重复,重复行会失败;
- 下载失败报告:任务完成后到 执行结果 页面生成逐行失败报告,按失败原因修正后重新导入;
- 已有卡按「企业编码 + ICCID」识别,不会重复创建,仅更新模板中明确提供的非空字段,无需担心重复导入产生重复卡。
停机 / 复机等操作没生效
现象:执行停机、复机、断网、开网后,卡的状态没有变化。
排查步骤:
- 确认操作为异步任务:控制操作经通道下发到运营商侧执行,提交后不会立即生效,请到 任务日志 查看执行结果;
- 确认通道可用:操作依赖通道下发,通道停用或凭据异常会导致操作失败;
- 核对能力支持情况:部分运营商模板不支持某些控制能力,页面会标注暂不支持,属正常现象;
- 任务执行成功但状态仍未变化时,可对卡执行「同步状态」拉取最新状态确认。
设备绑定匹配不到卡
现象:设备详情「物联卡」页签按卡号匹配时找不到目标卡。
排查步骤:
- 确认卡属于当前企业:匹配范围限定在当前企业内,跨企业的卡无法匹配;
- 确认设备为蜂窝通讯类型:仅蜂窝类通讯设备支持匹配与绑定,非蜂窝设备不提供新增绑定能力;
- 核对一机一卡约束:一张卡最多绑定一台活动设备,目标卡已被其他设备绑定时无法匹配,可先在卡侧解绑或换绑后再绑定;
- 设备上报的卡号仅用于预填和匹配,未上报时请人工输入卡号后重试。
更新日志
2026/8/1 21:35
查看所有更新日志
0139c-物联卡使用文档对标 IoTLink 官方文档细化扩写于
