调用生活物联网平台API出现错误时,您可以根据错误码信息来定位问题并尝试解决。

常见错误码

错误码 错误信息 描述 可尝试解决方法
200 success 请求成功。 不涉及。
400 request error 请求错误。 根据错误提示和日志自行定位解决或联系技术支持解决。
401 request auth error 请求认证错误。
  • 检查是否已使用AppKey、AppSecret登录。
  • 检查AppKey、AppSecret是否配置正确。
  • 检查请求是否携带token。
  • 针对配网绑定和设备控制接口,检查相关设备是否与当前用户绑定。
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 固件不存在。 检查传入的版本号是否正确。
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的限制。
10200 scene empty 没有这个场景。 确认场景是否存在,场景创建后需检查是否创建成功。
20004 gateway.backend service error 请检查当前的请求入参是否存在错误的入参。 检查当前的请求入参是否存在错误的入参,例如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上的提示文案 可尝试解决方法
6221 设备不在线。 添加失败,请检查设备状态。 将设备正确接入互联网,并检查设备的在线状态。
61701 配网超时,未找到目标设备热点。 未发现设备热点,请按引导初始化设备。 设备热点配网,检查设备是否进入配网模式。
61702 配网超时,未找到目标蓝牙Wi-Fi双模设备。 未搜索到设备蓝牙信号,请按引导初始化设备。 蓝牙辅助配网,检查设备是否进入配网模式。
61703 配网超时,蓝牙设备连接超时。 设备蓝牙连接超时,导致添加失败,请重试。 重试或切换配网方式。
61704 配网超时,获取双模设备信息超时。 获取设备蓝牙信息超时,导致添加失败,请重试。 重试或切换配网方式。
61705 配网超时,无目标设备连接手机热点。 未发现设备连接到手机热点,请按引导初始化设备。 手机热点模式,检查设备是否进入配网模式。
101600 系统错误。 添加失败,请重试或切换配网方式。 重试或切换配网方式。
101602 参数错误。 根据message提示来排查。
101603 未知错误。 添加失败,请重试或切换配网方式。 重试或切换配网方式。
101603+60301 SDK接口请求失败。 添加失败,请重试或切换配网方式。 根据message提示来排查或切换配网方式。
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已连接,然后重试。 提示用户手动开启手机预置的热点后再重新开始配网。
101616+61601 配网失败,蓝牙连接异常断开或连接失败。 家庭网络情况不佳,设备连接路由器失败,请重试。 重试或切换配网方式。
101616+61602 配网失败,蓝牙连接失败。 家庭网络情况不佳,设备连接路由器失败,请重试。 重试或切换配网方式。
101616+61605 配网失败,获取蓝牙Wi-Fi双模设备信息失败。 获取设备蓝牙信息失败,请重试。 重试或切换配网方式。
101616+61609 combo设备配网失败。 手机网络情况不佳,导致添加失败,请重试。 重试或切换配网方式。
101617+61701 未发现待配设备开启的设备热点。 手机网络情况不佳,导致添加失败,请重试。 检查是否选错配网入口,或者检查设备是否进入了配网模式。
101617+61702 未发现combo设备。 手机网络情况不佳,导致添加失败,请重试。 检查是否选错配网入口,或者检查设备是否进入了配网模式。
101617+61703 combo设备蓝牙连接失败。 手机网络情况不佳,导致添加失败,请重试。 尝试重启蓝牙开关后再重试。
101617+61706 设备热点连接失败。 手机网络情况不佳,导致添加失败,请重试。
  • 检查设备热点是否存在。
  • 检查配网入口是否选择正确。
  • 检查设备是否进入了配网模式。
101617+61709 配网失败,如果手机端网络正常,则是设备配网失败;如果手机端网络不正常,则网络问题导致失败。 手机网络情况不佳,导致添加失败,请重试。 重试配网操作。
101617+61708 配网失败,设备热点连接成功,手机网络和Wi-Fi均未连接。 手机网络情况不佳,导致添加失败,请重试。 重试配网操作。
101618 设备端返回的错误信息,一般为设备连云失败,详细参见本文档下方设备端错误码。 手机网络情况不佳,导致添加失败,请重试。 重新配网操作。
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换取AccessToken值失败。
100003 RefreshToken已过期或已失效。
100004 用户改密或解除授权导致AccessToken失效。
100005 AccessToken非法。
100006 无效的OpenId。
110000 系统通用错误(无法列出其他所有错误,需联系三方厂商)。

设备端错误码

错误码 设备所处状态 错误码说明 App展示的提示文案 解决办法
50176(0xC400) 配网准备阶段 Wi-Fi驱动失败。 设备添加失败,请重试。 重启设备再试或返厂检查。
50208(0xC420) 配网开启失败。 设备添加失败,请重试。 重启设备再试或返厂检查。
50240(0xC440) 一键配网 获取AP的SSID与PWD超时。 设备连接Wi-Fi超时,请重试。 尝试重启Wi-Fi开关后再重试。
50241(0xC441) 对端发来的配网协议版本号不符合。 设备工作异常,请联系售后支持或提交反馈。 检查移动端和设备端配网协议的版本号。
50242(0xC442) 配网报文校验出错。 设备工作异常,请联系售后支持或提交反馈。 确认设备固件以及设备证书信息是否正确。
50243(0xC443) 解码AP的SSID与PWD错误。 设备工作异常,请联系售后支持或提交反馈。 确认设备固件以及设备证书信息是否正确。
50272(0xC460) 设备热点配网 设备热点开启失败。 设备添加失败,请重试。 重启设备再试或返厂检查。
50273(0xC461) 设备热点启动后等待App连接超时。 设备等待手机连接超时,请重试。 确认对端行为并重试。
50274(0xC462) 设备热点被App连接后未收到过SSID与PWD。 设备连接Wi-Fi超时,请重试。 重启设备再试或返厂检查。
50275(0xC463) 设备热点配网中,对端发来的配网协议版本号不符合。 设备工作异常,请联系售后支持或提交反馈。 检查移动端和设备端版本号,或确认App发来的配网包数据是否正确。
50276(0xC464) 配网报文校验出错。 设备工作异常,请联系售后支持或提交反馈。 确认设备固件以及设备证书信息是否正确,或返厂检查。
50277(0xC465) 解码AP的SSID与PWD错误。 设备工作异常,请联系售后支持或提交反馈。 确认设备固件以及设备证书信息是否正确。
50278(0xC466) 设备热点切换到station模式失败。 设备热点切换失败,请重试。 重启设备再试或返厂检查。
50304(0xC480) 零配配网 等待零配超时(未收到SSID与PWD)。 设备连接Wi-Fi超时,请重试。 重试配网操作。
50305(0xC481) 对端发来的配网协议版本号不符合。 设备工作异常,请联系售后支持或提交反馈。 检查移动端和设备端版本号是否确认。
50306(0xC482) 配网报文校验出错。 设备工作异常,请联系售后支持或提交反馈。 确认设备固件以及设备证书信息是否正确。
50307(0xC483) 解码AP的SSID与PWD错误。 设备工作异常,请联系售后支持或提交反馈。 确认设备固件以及设备证书信息是否正确。
50336(0xC4A0) 蓝牙辅助配网 BLE广播开启失败。 设备蓝牙初始化失败,请重试。 重启设备再试或返厂检查。
50337(0xC4A1) BLE连接建立失败。 设备蓝牙连接失败,请重试。 确认蓝牙信号以及设备设备证书信息是否正确。
50338(0xC4A2) BLE连接建立后未收到过SSID与PWD。 设备连接Wi-Fi超时,请重试。 重试配网操作。
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初始化失败。 设备初始化失败,请重试。 重启设备再试或返厂检查。
50433(0xC501) HTTPS域名解析失败(附上域名信息)。 设备解析域名失败,请检查当前Wi-Fi是否正常。 检查当前路由器网络是否正常。
50434(0xC502) HTTPS预认证失败(认证超时)。 设备连接Wi-Fi超时,请检查当前Wi-Fi是否正常。 检查当前路由器网络是否正常,或检查预认证数据中含有非法字段。
50435(0xC503) HTTPS预认证失败(设备证书错误)。 设备工作异常,请联系售后支持或提交反馈。 确认设备设备证书信息是否正确,或根据云端返回的code提示排查。
50436(0xC504) MQTT开启失败。 设备初始化失败,请重试。 重启设备再试或返厂检查。
50437(0xC505) MQTT连云超时失败。 设备连接Wi-Fi超时,请检查当前Wi-Fi是否正常。 检查当前路由器网络是否正常。
50438(0xC506) MQTT认证失败。 设备工作异常,请联系售后支持或提交反馈。 确认设备证书信息是否正确,或根据具体错误消息排查。
50439(0xC507) 设备CoAP服务开启失败。 设备初始化失败,请重试。 重启设备再试或返厂检查。
50440(0xC508) 设备绑定token上报云端超时。 设备连接Wi-Fi超时,请检查当前Wi-Fi是否正常。 检查当前路由器网络是否正常。
50441(0xC509) 设备绑定token上报云端回应报文错误。 设备工作异常,请联系售后支持或提交反馈。 根据云端回应的报文错误来排查。
50442(0xC50A) 接收到同一局域网内其他设备的token查询请求的报文不合法。 设备工作异常,请联系售后支持或提交反馈。 查询云端请求消息确认具体原因。
50443(0xC50B) 对同一局域网内其他设备的token查询回复失败。 设备工作异常,请联系售后支持或提交反馈。 接口调用失败,需重启设备重试。