本文介绍物联网平台可能返回给设备端的错误码及说明。
公共错误码
| 错误码 | 原因 | 解决办法 | 
| 400 | 处理请求时出错。 | 提交工单。 | 
| 429 | 请求过于频繁,触发系统限流。 | 提交工单。 | 
| 460 | 设备上报的数据为空,或参数格式错误、参数的数量超过限制等原因。 | 按照Alink协议下具体文档中的数据格式,检查参数信息。 | 
| 500 | 系统发生未知异常。 | 提交工单。 | 
| 5005 | 查询产品信息失败。 | 在物联网平台控制台,查询产品信息,核对ProductKey。 | 
| 5244 | 查询LoRaWAN类型产品的元信息失败。 | 提交工单。 | 
| 6100 | 查询设备信息时,未查询到指定设备信息。 | 在物联网平台控制台的设备管理中,核对设备信息。 | 
| 6203 | 解析Topic时失败。 | 提交工单。 | 
| 6250 | 查询产品信息失败。 | 在物联网平台控制台的查询产品信息,核对ProductKey。 | 
| 6204 | 设备已被禁用,不能对设备进行操作。 | 在物联网平台控制台的设备管理中,查看设备状态。 | 
| 6450 | 自定义/透传格式数据经过脚本解析为Alink标准格式数据后,无method。 | 在物联网平台控制台的日志服务中,或设备本地日志中,检查设备上报的数据中是否有method参数。 | 
| 6760 | 系统异常。 | 提交工单。 | 
| 错误码 | 原因 | 排查 | 
| 26001 | 执行数据解析时,获取的脚本内容为空。 | 在物联网平台控制台,产品的数据解析页签下,确认脚本已提交。 说明  未提交的脚本不能被调用。 | 
| 26002 | 脚本执行正常,但脚本内容有问题,如脚本中语法错误。 | 使用相同的数据测试脚本。查看具体的错误信息,修改脚本。建议在本地详细的自验后,再提交到物联网平台。 | 
| 26006 | 脚本执行正常,脚本内容有误。脚本中,要求有protocolToRawData和rawDataToProtocol这两个服务。如果缺失,会报错。 | 在物联网平台控制台,产品的数据解析页签下,查询脚本内容中protocolToRawData和rawDataToProtocol服务是否存在。 | 
| 26007 | 脚本执行正常,但返回结果不符合格式要求。 脚本中,要求有protocolToRawData和rawDataToProtocol这两个服务。protocolToRawData返回byte[]数组, rawDataToProtocol要求返回JSON对象。如果返回结果不符合这两种格式,会报这个错。 | 在物联网平台控制台或在本地测试脚本,并查看返回结果的格式是否符合要求。 | 
| 26010 | 请求过于频繁,导致被限流。 | 提交工单。 | 
| 错误码 | 原因 | 排查 | 
| 5159 | TSL校验时,查询属性定义失败。 | 提交工单。 | 
| 5160 | TSL校验时,查询事件定义失败。 | 提交工单。 | 
| 5161 | TSL校验时,查询服务定义失败。 | 提交工单。 | 
| 6207 | 设备上报的Alink数据格式,或者调用脚本解析后返回的数据格式,不是JSON格式。 | 请参见设备属性、事件、服务,查看对应数据格式,并按格式要求上报数据。 | 
| 6300 | method不存在。TSL校验时,设备上报的Alink(标准)格式数据,或自定义(透传)格式数据经过脚本转换后,没有Alink协议要求的method参数。 | 在物联网平台控制台的日志服务,或者设备的本地日志中,查看上报数据中是否有method参数。 | 
| 6301 | TSL校验时,发现定义的数据为array类型,但上报的数据不是array类型。 | 在物联网平台控制台,产品的功能定义页签下,查看产品的TSL中对应数据格式,并按格式要求上报数据。 | 
| 6302 | TSL校验服务的入参时,发现缺少必需的参数。 | 在物联网平台控制台,查看设备所属产品的功能定义,查询对应服务的入参,核对传入的参数。 | 
| 6306 | TSL校验时,发现: 
 | 在物联网平台控制台,查看设备所属产品的功能定义,核对传入的参数类型和取值范围。 | 
| 6307 | 传入的参数不符合TSL中32位浮点数据的规范。TSL校验时,发现: 
 | |
| 6308 | 传入的参数不符合TSL中布尔类型数据的规范。TSL校验时,发现: 
 | |
| 6310 | 传入的参数不符合TSL中字符类型数据的规范。TSL校验时,发现: 
 | |
| 6322 | 传入的参数不符合TSL中64位浮点数据的规范。TSL校验时,发现: 
 | |
| 6304 | TSL校验时,发现传入的参数在结构体中不存在。 | 在物联网平台控制台,查看设备所属产品的功能定义,核对传入的参数类型。 | 
| 6309 | 传入的参数不符合TSL中枚举类型数据的规范。 | |
| 6311 | 传入的参数不符合TSL中日期类型数据的规范。TSL校验时,发现: 
 | |
| 6312 | 传入的参数不符合TSL中结构体类型数据的规范。TSL校验时,发现: 
 | |
| 6320 | 查询设备的TSL时,没有查询到设备的属性信息。 | 在物联网平台控制台,查看设备所属产品的功能定义中是否存在该属性。若不存在,需增加属性定义。 | 
| 6321 | 解析TSL时,发现属性、事件或者服务的标识符为空。 | 提交工单。 | 
| 6317 | TSL校验时,发现TSL中缺少关键信息,如type,specs为空。 | 提交工单。 | 
| 6324 | 传入的数组类型的参数不符合规范。TSL校验时,发现: 
 | 
 | 
| 6325 | 传入的数组类型参数中有不支持的元素类型。目前,数组中元素的类型只支持整型、32位浮点类型、64位浮点类型、字符串类型、结构体类型。 | 检查传入的数组元素类型是否是支持的类型。 | 
| 6326 | TSL校验时,检查上报的数据中time字段格式时报错。 | 请参见设备属性、事件、服务,查看对应数据格式,并按格式要求上报数据。 | 
| 6328 | TSL校验时,发现传入的参数不是数组类型。 | 在物联网平台控制台,查看设备所属产品的功能定义,核对传入的对应参数是否是数组类型。 | 
| 6318 | TSL解析时,系统异常。 | 提交工单。 | 
| 6313 | ||
| 6329 | ||
| 6323 | ||
| 6316 | ||
| 6314 | ||
| 6301 | 
设备接入Link SDK相关错误码
设备身份注册相关错误码
- 直连设备身份注册 - 请求Topic:/sys/${productKey}/${deviceName}/thing/sub/register
- 响应Topic:/sys/${productKey}/${deviceName}/thing/sub/register_reply
 - 错误码:460、5005、5244、500、6288、6100、6619、6292、6203 - 以下为设备身份注册的特有错误码说明,其他错误码说明请参见公共错误码章节。 - 错误码 - 原因 - 排查 - 6288 - 设备动态注册开关未打开。 - 在物联网平台控制台,设备所属的产品详情页,开启设备动态注册。 - 6619 - 设备已绑定到其它网关下。 - 在物联网平台控制台,该子设备的详情页,查看该设备是否已绑定网关。 
- 请求Topic:
- 直连设备一型一密动态注册 - 错误码:460、6250、6288、6600、6289、500、6292 - 以下为直连设备一型一密动态注册的特有错误码说明,其他错误码说明请参见公共错误码章节。 - 错误码 - 原因 - 排查 - 6288 - 设备动态注册开关未打开。 - 在物联网平台控制台,设备所属的产品详情页,开启设备动态注册。 - 6292 - 校验签名时,发现传入的签名方法不支持。 - 请使用设备身份注册中signMethod支持的签名方法。 - 6600 - 签名校验失败。 - 请按照设备身份注册中的签名方法计算签名,并校验签名。 - 6289 - 一型一密动态注册直连设备时,发现设备已激活。 - 在物联网平台控制台的设备管理中,查看该设备的状态。 
设备拓扑关系相关错误码
- 添加设备拓扑关系 - 请求Topic:/sys/${productKey}/${deviceName}/thing/topo/add
- 响应Topic:/sys/${productKey}/${deviceName}/thing/topo/add_reply
 - 错误码:460、429、6402、6100、401、6204、6400、6203 - 以下为添加设备拓扑关系的特有错误码说明,其他错误码说明请参见公共错误码章节。 - 错误码 - 原因 - 排查 - 401 - 添加拓扑关系时,校验签名信息失败。 - 请按照管理拓扑关系中的签名方法计算签名,并校验。 - 6402 - 网关与子设备是同一个设备。添加拓扑关系时,不能把当前网关作为子设备添加到当前网关下。 - 检查添加的子设备信息,是否有子设备信息和网关信息一致。 - 6400 - 为网关添加的子设备数量超过限制。 - 请参见使用限制,查看相关限制,并在物联网平台控制台,该网关设备的子设备管理页签下,查看已有子设备数量。 
- 请求Topic:
- 删除拓扑关系 - 请求Topic:/sys/${productKey}/${deviceName}/thing/topo/delete
- 响应Topic:/sys/${productKey}/${deviceName}/thing/topo/delete_reply
 - 错误码:460、429、6100、6401、6203 - 以下为删除设备拓扑关系的特有错误码说明,其他错误码说明请参见公共错误码章节。 - 错误码 - 原因 - 排查 - 6401 - 检查拓扑关系时,拓扑关系不存在。 - 在物联网平台控制台设备管理,网关设备的设备详情页子设备管理页签中,查看子设备信息。 
- 请求Topic:
- 获取拓扑关系 - 请求Topic:/sys/${productKey}/${deviceName}/thing/topo/get
- 响应Topic:/sys/${productKey}/${deviceName}/thing/topo/get_reply
 - 错误码:460、429、500、6203 - 错误码说明,请参见本文公共错误码章节。 
- 请求Topic:
- 网关上报发现子设备 - 请求Topic:/sys/${productKey}/${deviceName}/thing/list/found
- 响应Topic:/sys/${productKey}/${deviceName}/thing/list/found_reply
 - 错误码:460、500、6250、6280、6203 - 以下为特有错误码说明,其他错误码说明请参见公共错误码章节。 - 错误码 - 原因 - 排查 - 6280 - 网关上报的子设备名称不符合规范。设备名称字符仅支持中文汉字、英文字母、数字和下划线(_),长度范围4~32个字符,一个中文汉字算两个字符。 - 检查上报的设备名称是否符合规范。 
- 请求Topic:
子设备上下线相关错误码
- 子设备上线 - 接收消息的网关Topic: - /ext/session/${productKey}/${deviceName}/combine/login_reply- 错误码:460、429、6100、6204、6287、6401、500、9241、9240 
- 子设备主动下线异常 - 接收消息的网关Topic: - /ext/session/${productKey}/${deviceName}/combine/logout_reply- 错误码:460、520、500 
- 子设备被迫下线 - 接收消息的网关Topic: - /ext/error/${productKey}/${deviceName}- 错误码:427、521、522、6401 
- 子设备发送消息失败 - 接收消息的网关Topic: - /ext/error/${productKey}/${deviceName}- 错误码:520 
- 网关代理子设备批量上报消息失败 - 接收消息的网关Topic: - /sys/${productKey}/${deviceName}/proxy/batch_post_reply- 错误码:9242 
以下为设子设备上、下线相关的特有错误码说明,其他错误码说明请参见公共错误码章节。
| 错误码 | 原因 | 排查 | 
| 427 | 设备证书信息被其他设备使用,使设备被迫下线。 物联网平台仅以设备证书信息(productKey、deviceName、deviceSecret)来判断设备。 
 | 
 | 
| 428 | 单个网关下子设备数目超过最大值。 限制说明,请参见使用限制的网关与子设备。 | 请检查网关设备下的子设备数量。 | 
| 521 | 设备已被删除。 | 在物联网平台控制台的设备管理页搜索设备,确认设备是否已被删除。 | 
| 522 | 设备已被禁用。 | 在物联网平台控制台的设备管理页查看设备状态。 | 
| 520 | 子设备会话错误。 
 | |
| 6287 | 按照产品或者设备的密钥校验签名失败。 | 请参见子设备上下线中的签名方法计算签名,并校验。 | 
| 1914 | 单个批量上下线请求中,包含的子设备数量超过限制(5个)。 | 检查子设备批量上下线数量是否超过阈值。 | 
| 1913 | 网关离线导致子设备被云端自动离线。 | 根据日志服务查询网关离线原因。 | 
| 9242 | 一个批量上报消息请求中,网关代理子设备批量上报的消息条数超出限制(50条)。 | 检查子设备批量上报的消息条数是否超过阈值。 | 
| 9241 | 网关代理子设备上线请求中,在线设备不能修改连接的设备类型。 连接的设备类型说明,请参见MQTT客户端直连中的conntype。 | 检查网关设备和子设备是否已在线。 | 
| 9240 | 一个批量上下线请求中,状态相关网关设备下子设备数量超出限制(10,000)。 | 检查子设备批量上下线数量是否超过阈值。 | 
设备属性、事件、服务相关错误码
- 设备上报属性 - 透传数据格式: - 请求Topic: - /sys/${productKey}/${deviceName}/thing/model/up_raw
- 响应Topic: - /sys/${productKey}/${deviceName}/thing/model/up_raw_reply
 
- Alink数据格式: - 请求Topic: - /sys/${productKey}/${deviceName}/thing/event/property/post
- 响应Topic: - /sys/${productKey}/${deviceName}/thing/event/property/post_reply
 
 - 错误码:460、500、6250、6203、6207、6313、6300、6320、6321、6326、6301、6302、6317、6323、6316、6306、6307、6322、6308、6309、6310、6311、6312、6324、6328、6325、6200、6201、26001、26002、26006、26007 - 以下为上报属性的特有错误码说明,其他错误码说明请参见公共错误码章节。 - 错误码 - 原因 - 排查 - 6106 - 上报的属性数据过多。设备一次上报的有效属性个数不能超过200个。 - 在物联网平台控制台,中,或设备本地的日志中,检查上报的属性个数。 
- 设备上报事件 - 透传数据格式: - 请求Topic: - /sys/${productKey}/${deviceName}/thing/model/up_raw
- 响应Topic: - /sys/${productKey}/${deviceName}/thing/model/up_raw_reply
 
- Alink格式数据: - 默认模块 - 请求Topic: - /sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post
- 响应Topic: - /sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post_reply
 
- 自定义模块: - 请求Topic: - /sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:${tsl.event.identifier}/post
- 响应Topic: - /sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:${tsl.event.identifier}/post_reply
 
 
 - 错误码:460、500、6250、6203、6207、6313、6300、6320、6321、6326、6301、6302、6317、6323、6316、6306、6307、6322、6308、6309、6310、6311、6312、6324、6328、6325、6200、6201、26001、26002、26006、26007 - 错误码说明,请参见本文公共错误码章节。 
- 网关批量上报子设备数据 - 透传数据格式: - 请求Topic: - /sys/${productKey}/${deviceName}/thing/model/up_raw
- 响应Topic: - /sys/${productKey}/${deviceName}/thing/model/up_raw_reply
 
- Alink格式数据: - 请求Topic: - /sys/${productKey}/${deviceName}/thing/event/property/pack/post
- 响应Topic: - /sys/${productKey}/${deviceName}/thing/event/property/pack/post_reply
 
 - 错误码:460、6401、6106、6357、6356、6100、6207、6313、6300、6320、6321、6326、6301、6302、6317、6323、6316、6306、6307、6322、6308、6309、6310、6311、6312、6324、6328、6325、6200、6201、26001、26002、26006、26007 - 以下为网关批量上报子设备数据失败的特有错误码说明,其他错误码说明请参见公共错误码章节。 - 错误码 - 原因 - 排查 - 6401 - 拓扑关系不存在。 - 在物联网平台控制台,网关设备的子设备管理页签下,确认其子设备信息。 - 6106 - 上报的属性数据过多。设备一次上报的有效属性个数不能超过200个。 - 在物联网平台控制台,中,或设备本地的日志中,检查上报的属性个数。 - 6357 - 子设备数据过多。网关代替子设备上报数据,一次上报最多可包含20个子设备的数据。 - 查看设备本地日志中的上报数据。 - 6356 - 上报的事件数据过多。网关代替子设备上报数据,一次上报的事件个数不可超过200。 - 查看设备本地的日志中的上报数据。 
设备期望属性值相关错误码
- 设备获取期望属性值 - 请求Topic:/sys/${productKey}/${deviceName}/thing/property/desired/get。
- 响应Topic:/sys/${productKey}/${deviceName}/thing/property/desired/get_reply。
 - 错误码:460、6104、6661、500 - 以下为设备期望属性值操作失败的特有错误码说明,其他错误码说明请参见公共错误码章节。 - 错误码 - 原因 - 排查 - 6104 - 请求中包含的属性个数过多。一次请求可包含的属性个数不能超过200个。 - 在物联网平台控制台,中,或者设备本地日志中,查看上报数据中的属性个数。 - 6661 - 查询期望属性失败。系统异常。 - 提交工单排查。 
- 请求Topic:
- 设备清空期望属性值 - 请求Topic:/sys/${productKey}/${deviceName}/thing/property/desired/delete。
- 响应Topic:/sys/${productKey}/${deviceName}/thing/property/desired/delete_reply。
 - 错误码:460、6104、6661、500、6207、6313、6300、6320、6321、6326、6301、6302、6317、6323、6316、6306、6307、6322、6308、6309、6310、6311、6312、6324、6328、6325 
- 请求Topic:
设备标签相关错误码
- 设备上报标签信息 - 请求Topic:/sys/${productKey}/${deviceName}/thing/deviceinfo/update
- 响应Topic:/sys/${productKey}/${deviceName}/thing/deviceinfo/update_reply
 - 错误码:460、6100 
- 请求Topic:
- 设备删除标签信息 - 请求Topic:/sys/${productKey}/${deviceName}/thing/deviceinfo/delete
- 响应Topic:/sys/${productKey}/${deviceName}/thing/deviceinfo/delete_reply
 - 错误码:460、500 
- 请求Topic:
获取TSL模板相关错误码
- 请求Topic: - /sys/${productKey}/${deviceName}/thing/dsltemplate/get
- 响应Topic: - /sys/${productKey}/${deviceName}/thing/dsltemplate/get_reply
错误码:460、5159、5160、5161
设备请求升级包信息相关错误码
- 请求Topic: - /sys/${productKey}/${deviceName}/thing/ota/firmware/get
- 响应Topic: - /sys/${productKey}/${deviceName}/thing/ota/firmware/get_reply
错误码:429、9112、500
以下为设备请求升级包信息的特有错误码,其他错误码,请参见公共错误码章节。
| 错误码 | 原因 | 排查 | 
| 9112 | 未查询到指定的设备信息。 | 在物联网平台控制台的设备管理中,确认设备信息是否正确。 | 
设备请求配置信息相关错误码
- 请求Topic:/sys/${productKey}/${deviceName}/thing/config/get
- 响应Topic:/sys/${productKey}/${deviceName}/thing/config/get_reply
错误码:460、500、6713、6710
以下为设备请求配置信息的特有错误码,其他错误码,请参见公共错误码章节。
| 错误码 | 原因 | 排查 | 
| 6713 | 远程配置服务不可用。该产品的远程配置开关未打开。 | 在物联网平台控制台,中,打开该产品的远程配置开关。 | 
| 6710 | 未查询到远程配置信息。 | 在物联网平台控制台,中,查看是否为该产品编辑了远程配置文件。 | 
设备自定义任务相关错误码
- 设备获取自定义任务详情 - 请求Topic:/sys/${productKey}/${deviceName}/thing/job/get。
- 响应Topic:/sys/${productKey}/${deviceName}/thing/job/get_reply。
 - 错误码:71012、71034、71035 
- 请求Topic:
- 设备更新任务下作业状态 - 请求Topic:/sys/${productKey}/${deviceName}/thing/job/update。
- 响应Topic:/sys/${productKey}/${deviceName}/thing/job/update_reply。
 - 错误码:71018、71019、71034、71035 
- 请求Topic:
| 错误码 | 原因 | 排查 | 
| 71012 | 设备获取任务详情中,发起请求的数据格式不是JSON格式。 | 请参见获取设备任务详情,查看正确的数据格式,并按照数据格式上报请求。 | 
| 71018 | 任务已处于以下任一状态: 
 | 在物联网平台控制台的的任务列表中,确认目标任务的状态。 | 
| 71019 | 任务下作业的ID不存在。 | 在物联网平台控制台的页面,进入目标任务的页签,确认作业ID是否存在。 | 
| 71034 | 任务下作业ID不属于当前设备。 | 在物联网平台控制台的页面,进入目标任务的页签,确认当前设备是否包含该作业ID。 | 
| 71035 | 
 | 在物联网平台控制台的页面,进入目标任务的任务详情页面: 
 | 
设备上传文件相关错误码
上传文件的数据格式和参数说明,请参见文件上传。
- 设备请求上传文件 - 请求Topic:/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/init。
- 响应Topic:/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/init_reply。
 - 错误码:78117、78123、78124、78125 
- 请求Topic:
- 设备上传文件分片 - 请求Topic:/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/send。
- 响应Topic:/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/send_reply。
 - 错误码:78118、78119、78120、78121、78122、78124、78125、78126 
- 请求Topic:
| 错误码 | 原因 | 排查 | 
| 78117 | 设备请求上传文件的大小超出最大限制(16 MB)。 | 确认待上传文件大小是否符合要求。 | 
| 78118 | 设备上传文件分片的大小超出最大限制(128 KB)。 | 确认上传文件的分片大小是否符合要求。详细信息 ,请参见上传文件。 | 
| 78120 | 设备上传文件分片的大小不满足最小限制(256 B)。 | |
| 78119 | 设备上传后续文件分片时的offset值,与实际已上传到物联网平台云端的文件大小不一致。 | 确认设备上传文件分片时的offset的值是否正确。 | 
| 78121 | 设备上传文件分片时,当前文件分片的文件完整性校验失败。 | 根据CRC算法校验的错误信息,排查原因。 | 
| 78122 | 设备上传文件的任务不存在。 | 确认上传文件的标识ID是否正确或存在。 | 
| 78123 | 同名文件已存在。 | 确认设备端设置的文件处理策略,是否支持上传同名文件。详细信息 ,请参见上传文件。 | 
| 78124 | 文件上传任务已经完成。 重要  针对已完成上传的文件,设备端不能再进行上传文件分片和取消文件上传任务的操作。 | 确认物联网平台是否已存在上传的文件,具体操作,请参见查看文件。 | 
| 78125 | 文件完整性校验失败。 | 确认物联网平台云端计算的文件完整性校验值,是否与设备上传文件时的完整性校验值相同。 | 
| 78126 | 设备端并行上传了文件的同一分片数据。 | 确认设备端是否收到当前分片数据的响应消息后,再发送的下一个分片数据。 |