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