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

常见错误码

错误码 错误信息 描述 可尝试解决方法
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 当前连接的Wi-Fi是5G网络,不支持配网 提示用户切换到2.4G网络
60102 NETWORK_ERROR Wi-Fi未连接 提示用户开启Wi-Fi连接
60103 NETWORK_ERROR 手机流量未开启或者无SIM卡 提示用户当前配网方式需要SIM卡,且需要开启上网功能
60201 PARAMS_ERROR productKey为空 检查linkType是否为空,或不支持,或需要的参数未填
60202 PARAMS_ERROR linkType错误 检查linkType是否为空,或不支持,或需要的参数未填
60203 PARAMS_ERROR deviceType错误 检查deviceType是否需要配网或者为非Wi-Fi设备
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类型 请检查当前的请求入参是否存在错误的入参,例如JSON入参传递了JSONString类型
20017 非法cloudToken或超时 CloudToken非法或请求超时 通过云端资源接口重新获取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 批次已经创建 请检查批次是否已存在
28081 aliyun account not register phone number 阿里云账号未注册手机号码 补充阿里云账号对应手机号码
28082 sms send fail 信息发送失败 补充阿里云账号对应手机号码
28083 The format of the product name is incorrect 产品名称格式不正确 请按照格式要求修改产品名称
28501 project is not exist 项目不存在 操作前检查项目是否已经存在
28502 alarm record is not exist 告警记录不存在 操作前检查告警记录是否已经存在
28504 device is offline 设备不在线 操作前检查设备是否已经上线
28505 product not exist 产品不存在 操作前检查产品是否存在
28517 invalid iot id 无效的iotId 确认传入的iotId是否存在
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 不支持的设备类型 检查设备类型是否正确
28573 No permission to bind the device 当前APP无法添加该设备,请联系售后支持 检查该设备对应的产品是否为App的关联产品
28601 user device not bind 用户设备没有绑定 操作前确认用户与设备的绑定关系
28603 Remove all devices in this group before deleting it 请移除分组内的设备后再删除分组 操作前确认分组内已无设备
28604 The group does not exist 该分组不存在 操作前确认分组是否存在
28605 "You are not authorized to delete \"all devices\" or the devices in this group. “全部设备”及该分组下的设备不可删除 不要删除“全部设备”及该分组下的设备
29003 identityId is null identityId为空 检查用户是否登录了其他App
29004 device is unbind 设备已解绑 请确认设备是否已解绑

配网错误码

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

家空间错误码

错误码 错误信息 描述 可尝试解决方法
28804 Duplicate name. 家空间名称重复 修改家空间的名称
28805 Invalid name. 家空间名称非法,仅支持字母、数字、空格和汉字 按照要求修家空间的名称
28806 This feature is not supported by the current app version. Please upgrade to the latest version. 当前App版本不支持此功能,请升级到最新版本 请升级App版本
28807 Up to 100 devices can be added. 最多添加100个设备 请确认已添加设备的数量
28808 The maximum number of room that you can create is exceeded. 最多新建20个房间 请确认已创建房间的数量
28809 The maximum number of home that you can create is exceeded. 最多新建10个家庭 请确认已创建家庭的数量
28810 Under the low limit of the number of home. 无法删除,至少保留一个家庭 请确认当前是否仅有一个家庭
28811 One device only can be added to one group. 一个设备只能添加到一个设备组 请确认是否存在设备组
28812 Only letters,numbers and Chinese characters are supported. Must be less than 20 characters. 仅支持字母、数字、空格和汉字,长度最大支持20个字符 请按照规定修改
28813 Only letters,numbers and Chinese characters are supported. Must be less than 40 characters. 仅支持字母、数字、空格和汉字,长度最大支持40个字符 请按照规定修改
28820 Add at least 2 devices. 至少添加2个设备 请确认当前设备的数量
28821 Up to 20 groups can be added. 最多添加20个设备组 请确认当前设备组的数量
28823 Up to 100 devices can be added. 最多添加100个设备 请确认当前设备的数量

公共返回码

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

设备端错误码

错误码 错误码说明 App展示的提示文案 解决办法
50176(0xC400) Wi-Fi驱动失败 设备添加失败,请重试 驱动调用失败,重启设备再试或返厂检查
50208(0xC420) 配网开启失败 设备添加失败,请重试 驱动调用失败,重启设备再试或返厂检查
50240(0xC440) 获取AP的SSID与PWD超时 设备连接Wi-Fi超时,请重试 SSID与PWD获取超时,需重试
50241(0xC441) 对端发来的配网协议版本号不符合 设备工作异常,请联系售后支持或提交反馈 配网协议版本不符,检查移动端和设备端版本号确认
50242(0xC442) 配网报文校验出错 设备工作异常,请联系售后支持或提交反馈 配网报文校验出错,需确认设备固件以及设备证书信息是否有误
50243(0xC443) 解码AP的SSID与PWD错误 设备工作异常,请联系售后支持或提交反馈 配网报文解析出错,需确认设备固件以及设备证书信息是否有误
50272(0xC460) 设备热点开启失败 设备添加失败,请重试 驱动调用失败,重启设备再试或返厂检查
50273(0xC461) 设备热点启动后等待App连接超时 设备等待手机连接超时,请重试 设备热点等待连接超时,需确认对端行为并重试
50274(0xC462) 设备热点被App连接后未收到过SSID与PWD 设备连接Wi-Fi超时,请重试 SSID与PWD获取超时,需重试设备状态不对,或回包给App时设备底层出错
50275(0xC463) 对端发来的配网协议版本号不符合 设备工作异常,请联系售后支持或提交反馈 配网协议版本不符,检查移动端和设备端版本号确认App发来的配网包数据不对
50276(0xC464) 配网报文校验出错 设备工作异常,请联系售后支持或提交反馈 配网报文校验出错,需确认设备固件以及设备证书信息是否有误设备校验配网包数据时设备底层出错,导致设备校验出错
50277(0xC465) 解码AP的SSID与PWD错误 设备工作异常,请联系售后支持或提交反馈 配网报文解析出错,需确认设备固件以及设备证书信息是否有误
50278(0xC466) 设备热点切换到station模式失败 设备热点切换失败,请重试 驱动调用失败,重启设备再试或返厂检查
50304(0xC480) 等待零配超时(未收到SSID与PWD) 设备连接Wi-Fi超时,请重试 SSID与PWD获取超时,需重试
50305(0xC481) 对端发来的配网协议版本号不符合 设备工作异常,请联系售后支持或提交反馈 配网协议版本不符,检查移动端和设备端版本号确认
50306(0xC482) 配网报文校验出错 设备工作异常,请联系售后支持或提交反馈 配网报文校验出错,需确认设备固件以及设备证书信息是否有误
50307(0xC483) 解码AP的SSID与PWD错误 设备工作异常,请联系售后支持或提交反馈 配网报文解析出错,需确认设备固件以及设备证书信息是否有误
50336(0xC4A0) BLE广播开启失败 设备蓝牙初始化失败,请重试 蓝牙驱动调用失败,重启设备再试或返厂检查
50337(0xC4A1) BLE连接建立失败 设备蓝牙连接失败,请重试 蓝牙连接失败,需确认蓝牙信号以及设备设备证书信息是否正确
50338(0xC4A2) BLE连接建立后未收到过SSID与PWD 设备连接Wi-Fi超时,请重试 SSID与PWD获取超时,需重试
50339(0xC4A3) 对端发来的配网协议版本号不符合 设备工作异常,请联系售后支持或提交反馈 配网协议版本不符,检查移动端和设备端版本号确认
50340(0xC4A4) 配网报文校验出错 设备工作异常,请联系售后支持或提交反馈 配网报文校验出错,需确认设备固件以及设备证书信息是否有误
50341(0xC4A5) 解码AP的SSID与PWD错误 设备工作异常,请联系售后支持或提交反馈 配网报文解析出错,需确认设备固件以及设备证书信息是否有误
50342(0xC4A6) BLE连接断开失败 蓝牙断开失败,请重试 蓝牙断开失败,从手机端断开蓝牙连接或重启设备
50343(0xC4A7) BLE广播关闭失败 蓝牙关闭失败,请重试 蓝牙驱动调用失败,重启设备再试或返厂检查
50400(0xC4E0) 路由器无法发现 未找到可用的Wi-Fi,请检查以下问题后重试:
  • Wi-Fi信号是否正常
  • 设备与路由器距离是否较远
  • 路由器Wi-Fi是否正确
需确认路由器信号,SSID输入是否正确,路由器是否处于2.4G工作频段
50401(0xC4E1) 路由器信号太弱连接失败(附上rssi信息) 设备连接Wi-Fi失败,请检查以下问题后重试:
  • Wi-Fi信号是否正常
  • 设备与路由器距离是否较远
需确认路由器信号,以及设备与路由器之间的距离
50402(0xC4E2) 路由器连接认证失败 设备连接Wi-Fi失败,请重新输入正确的Wi-Fi密码 需确认配网阶段输入的SSID/密码是否正确
50403(0xC4E3) IP地址获取失败 设备连接Wi-Fi失败,请检查路由器设置是否正常 需检查路由器是否工作正常,以及确认是否还能再加入STA路由器连接失败,可能情况有多种
50404(0xC4E4) 连接路由器本地通告失败 设备工作异常,请重试 接口调用失败,需重启设备重试
50432(0xC500) https初始化失败 设备初始化失败,请重试 驱动调用失败,重启设备再试或返厂检查https初始化出错表明设备底层系统已经出错,Host等信息都出现了错误
50433(0xC501) https域名解析失败(附上域名信息) 设备解析域名失败,请检查当前Wi-Fi是否正常 https域名解析失败,需检查当前路由器网络是否正常
50434(0xC502) https预认证失败(认证超时) 设备连接Wi-Fi超时,请检查当前Wi-Fi是否正常 https预认证失败超时,需检查当前路由器网络是否正常预认证数据中含有非法字段导致
50435(0xC503) https预认证失败(设备证书错误) 设备工作异常,请联系售后支持或提交反馈 https预认证失败,需确认设备设备证书信息是否正确云端返回明确的code指示错误
50436(0xC504) mqtt开启失败 设备初始化失败,请重试 驱动调用失败,重启设备再试或返厂检查
50437(0xC505) mqtt连云超时失败 设备连接Wi-Fi超时,请检查当前Wi-Fi是否正常 mqtt连云超时,需检查当前路由器网络是否正常分证书失效、认证被拒绝、服务端无法进行认证等情况
50438(0xC506) mqtt认证失败 设备工作异常,请联系售后支持或提交反馈 mqtt认证失败,需确认设备设备证书信息是否正确失败可能情况有许多种,需要根据具体错误消息确认
50439(0xC507) 设备coap服务开启失败 设备初始化失败,请重试 驱动调用失败,重启设备再试或返厂检查
50440(0xC508) 设备绑定token上报云端超时 设备连接Wi-Fi超时,请检查当前Wi-Fi是否正常 token上报云端超时,需检查当前路由器网络是否正常
50441(0xC509) 设备绑定token上报云端回应报文错误 设备工作异常,请联系售后支持或提交反馈 token上报云端回应报文错误,需云端查询具体原因
50442(0xC50A) 接收到同一局域网内其他设备的token查询请求的报文不合法 设备工作异常,请联系售后支持或提交反馈 token查询请求的报文不合法,需查询端确认具体原因
50443(0xC50B) 对同一局域网内其他设备的token查询回复失败 设备工作异常,请联系售后支持或提交反馈 接口调用失败,需重启设备重试