介绍生活物联网平台在开发指南中遇到的错误码,以及对应的错误信息描述和可尝试解决方法。

常见错误码

错误码 错误信息 描述 可尝试解决方法
200 success 成功
400 request error 请求错误
401 request auth error 请求认证错误
  • 尝试检查是否已经使用appKey,appSecret登录
  • 检查appKey,appSecret是否配置错误
  • 针对配网绑定和设备控制接口,请检查相关设备是否与当前用户绑定
403 request forbidden 请求被禁止
  • 检查appKey,appSecret是否配置错误
  • 当前使用的appKey是否有接口访问权限
404 service not found 服务未找到
  • 检查服务请求Method是否正确
  • 检查服务请求路径是否正确
429 too many requests 太多请求 当前时间段内请求过于频繁,可者降低调用频次或稍后重试
460 request parameter error 请求参数错误 业务参数异常,请检查上传的业务参数是否正确
batch device amount invalid 非法的量产设备数 检查量产设备数量
invalid count or offset 无效的count或offset,count须大于0, offset大于等于0 检查count(分页查询数量)和offset(查询偏移量)的值是否正确
500 service error 服务端错误 服务端发生未知异常,联系服务人员解决
503 service not available 服务不可用 服务端发生未知异常,联系服务人员解决
2000 param is invalid 请求参数错误
  • 请检查各入参信息是否存在错误
  • 检查是否将ProductKey填写错误
2062 identityId does not exist identityId不存在
  • 请检查当前是否正确进行账户登录和认证
  • iotToken信息是否过期或传输错误
2063 iotId not exist 设备不存在 检查传入的 iotId 是否正确
2065 identityId and iotId not bound 设备和账号未绑定 当前登录的账号和设备之间没有绑定关系,请确定当前的账户与设备确实存在绑定关系
2066 identityId is not manager 该用户不是设备的管理员 检查该用户与设备的分享关系
2073 this product not support share 该设备的分享模式不支持生成二维码,例如:抢占式设备不支持分享 调用前尝试检查设备的分享模式
2074 query msg-center hsf error 调用消息中心错误 服务端发生未知异常,需要联系服务人员
2075 share model not config for this product 分享模式未配置 产品没有设置分享模式,前往产品开发中心配置分享模式
2077 can't get identityId by email and mobile 无法根据手机号或影响找到用户identityId 没有该用户,尝试重新输入
2078 not the same initiator when cancel share dev or scene 不是同一个发起者 非该用户发起的分享无法取消该分享,调用前请检查是否为自己发起的分享
2082 receiver has reject share 接收者已拒绝分享 该分享已被操作,无法取消已被操作的分享
2085 receiver has agree share 接收者已同意分享 该分享已被操作,无法取消已被操作的分享
2086 can not share to oneself 不能分享给自己 检查是否将设备的分享人填写为自己
2087 iotId has bind to target user 设备和目标用户已绑定 重复操作,操作之前检查是否已经将设备与用户绑定
2088 forbidden to repeat launch share 不允许重复分享 检查是否已配置分享
2093 forbidden to repeat cancel sharing 不允许重复取消 重复操作,操作之前检查分享状态
2096 sharing time expired 分享已过期 尝试重新分享
2097 sharing record not exist 分享不存在 检查是否存在该分享
20050 xxx required 必填参数缺失 检查接口的必填字段是否填写
28538 event id is invalid or not exist 无效的事件告警 id 检查传入的 eventId 是否正确
5005 product not found 产品没有找到 检查ProductKey填写是否正确
5225 query product failed 查询产品失败 检查传入的ProductKey是否正确
600 SYSTEM_ERROR 系统错误 重试并切换配网方式
603 UNKNOWN_ERROR 未知错误
604 SDK_ERROR SDK内部错误 重试并切换配网方式
605 USER_CANCEL 用户取消配网
606 SERVER_FAIL 服务端请求失败 根据日志查看错误类型
607 PROVISION_TIMEOUT 配网超时 稍后重试
60101 NETWORK_ERROR 当前连接的Wifi是5G网络,不支持配网 提示用户切换到2.4G网络
60102 NETWORK_ERROR WiFi未连接 提示用户开启WiFi连接
60103 NETWORK_ERROR 手机流量未开启或者无SIM卡 提示用户当前配网方式需要SIM卡,且需要开启上网功能
60201 PARAMS_ERROR productKey为空 检查linkType是否为空,或不支持,或需要的参数未填
60202 PARAMS_ERROR linkType错误 检查linkType是否为空,或不支持,或需要的参数未填
60203 PARAMS_ERROR deviceType错误 检查deviceType是否需要配网或者为非WiFi设备
60204 PARAMS_ERROR 配网参数错误 检查配网参数,如配网版本号是否匹配
60205 PARAMS_ERROR SSID为空 传递正确的SSID
6100 device not found 设备不存在 检查传入的iotId是否正确
6289 device is already active 当前提供的设备信息已在云端存在 检查当前传递的设备信息是否存在重复提交
6608 token not found 设备上报的token信息不存在 token为必填字段,检查是否已填写
9103 update data failed 升级失败 查询设备端上报日志定位错误
9112 there is no device exist 设备不存在 检查传入的iotId是否正确
9119 firmware not exist 固件不存在 检查传入的version版本号是否正确
9131 invalid device 非法的设备
9132 non-existent job record 升级任务记录不存在 确认设备是否进行过固件升级的操作
9143 upgrade info posted is invalid 升级进度上报错误
9144 device count exceeded 设备数量超限
9146 upgrade record not exist 升级记录不存在 确认设备进行过该版本的固件升级
9153 device auth failed 设备校验失败
10196 device exist circle 设备存在循环依赖(要求:特定产品的特定属性在TCA中不能重复出现)
10197 scene exist circle 场景存在循环依赖(要求:action中指定的场景不能形成环闭合) 重新检查场景逻辑内是否存在循环依赖
10198 scene depth illegal 场景嵌套深度非法(要求:场景最多嵌套一层场景) 场景在一层逻辑节点下最多嵌套一层判断节点,检查是否存在逻辑节点嵌套错误
10199 scene width illegal action中场景个数非法(要求action中场景个数不能超过100) 检查action中场景个数是否超出限制
10200 scene empty 没有这个场景 确认场景是否存在,或场景创建后未检查是否创建成功
20004 gateway.backend service error 请检查当前的请求入参是否存在错误的入参,例如JSON入参传递了JSONString类型
20017 非法cloudToken或超时 请检查当前使用的CloudToken是否为通过云端资源接口获取的token,且token在有效期内 通过云端资源接口重新获取token,并且在有效期内刷新token
24063 query device failed 查询设备信息失败 检查提供的设备ID信息是否存在错误,或提供了一个非法的设备ID信息
28008 product not exist 产品不存在 检查产品是否存在
28036 no activation code quota 激活码余量不足 购买激活码
28038 product not release 产品未发布 发布该产品
28044 no valid device name 没有合法的设备名 检查设备证书是否正确
28045 device name checking 设备名检查中 检查设备证书是否正确或稍后重试
28046 batch has created 批次已经创建
28504 device is offline 设备不在线 操作前检查设备是否已经上线
28514 tenant not match 租户不匹配 确认租户信息
28532 invalid user info 无效的用户身份信息 确认传入的用户身份ID是否存在
28527 user not bind with lock 钥匙还未和虚拟用户绑定 没有云端创建该虚拟锁用户,检查是否在云端创建了该锁的用户
28528 operation type not support 不支持当前传入的虚拟用户信息更新操作类型 指定的操作类型错误,重新检查代码中相关枚举是否正确(1-添加,2-更新,3-删除)
28529 virtual user attr list is empty 虚拟用户的属性列表为空 传入的用户属性及属性值为空,请检查传入的相关参数值
28530 lock user has been bound to other virtual user 钥匙已经和其他虚拟用户绑定 为新用户重新创建新的钥匙
28551 user no register or router 用户没有绑定已配网设备或路由器
28560 device not exist 设备不存在 检查传入的iotid
28563 ble device bind sign error 蓝牙设备验签不通过
  • 检查签名的设备证书信息与产品信息是否设置正确
  • 检查签名设置是否符合规范
28566 product not exist 产品不存在 检查是否传入了合法存在的productKey
28567 device must be gprs device 必须是GPRS设备 操作前检查设备网络类型
28571 device types that are not supported 不支持的设备类型 检查设备类型是否正确
28601 user device not bind 用户设备没有绑定 操作前确认用户与设备的绑定关系
29003 identityId is null identityId为空 检查用户是否登录了其他App
29004 device is unbind 设备已解绑

配网错误码

错误码 错误描述 可尝试解决方法 公版APP上的提示文案
61701 配网超时,未找到目标设备热点 设备热点配网,检查设备是否进入配网模式 未发现设备热点,请按引导初始化设备。
61701 配网超时,未找到目标蓝牙Wi-Fi双模设备 蓝牙辅助配网,检查设备是否进入配网模式 未搜索到设备蓝牙信号,请按引导初始化设备。
61703 配网超时,蓝牙设备连接超时 重试或切换配网方式 设备蓝牙连接超时,导致添加失败,请重试。
61704 配网超时,获取双模设备信息超时 重试或切换配网方式 获取设备蓝牙信息超时,导致添加失败,请重试。
61705 配网超时,无目标设备连接手机热点 手机热点模式,检查设备是否进入配网模式 未发现设备连接到手机热点,请按引导初始化设备。
101600 / 101603 /101604 系统错误/未知错误/内部错误等(其他错误) 重试或者切换方案,通用提醒 添加失败,请重试或切换另一种配网方式。
101609 本地获取绑定Token超时 绑定失败,重试或切换配网方式 添加失败,请重试或切换另一种配网方式。
101601+60101 当前连接的Wifi是5G网络,不支持配网 提示用户切换到2.4G网络 不支持当前网络,请切换到2.4G网络。
101601+60102 Wifi未连接或过程中WiFi断开 提示用户开启Wifi连接或检查WiFi 手机Wi-Fi连接不稳定,请确保手机Wi-Fi已连接,然后重试。
101601+60104 手机热点配网,AP热点未打开 提示用户手动开启aha热点之后再重新开始配网 您的手机热点“aha”未开启,请按引导重试。
101616+61601 配网失败,蓝牙连接异常断开或连接失败 重试配网 家庭网络情况不佳,设备连接路由器失败,请重试。
101616+61605 配网失败,获取蓝牙WiFi双模设备信息失败 重试配网 获取设备蓝牙信息失败,请重试。
999103 访问云端接口错误异常,超时 检查手机网络连接 手机网络情况不佳,导致添加失败,请重试。

公共返回结果码约定

结果码 说明
0 成功
100001 AccessToken过期
100002 用code换取access token值失败
100003 RefreshToken已过期或已失效
100004 用户改密或解除授权导致AccessToken失效
100005 AccessToken非法
100006 无效的OpenId
110000 系统通用错误(无法列出其他所有错误,需联系三方厂商)