常见问题
问题清单
产品开发问题
创建产品,未找到适配的品类。
a. 公有云开发者,可联系平台客服提交品类需求。
b. 私有云用户可以在云管平台新增需要的品类后,再创建产品。
自定义功能未在设备生效。
请确认设备是否进行自定义功能的开发。
语音配置错误。
爱星物联平台和第三方语音平台映射类型配置错误。
产品开发完成无法点击。
a. 检查是否配置功能点。
b. 检查是否选择模组或自定义固件。
c. 检查是否选择控制面板。
设备调试问题
未能发现设备热点。
a. 设备没有进入配网模式,没有开启AP广播或是BLE广播(设备可能已配网上线了或是设备已配网未上线)。 解决方案:需通过AT指令或是删除设备或是其他方式让模组进入配网模式。 b. 设备已进入配网模式,而设备没有开启AP热点或是BLE广播。 解决方案:设备存在bug,可能没有真正进入配网模式,开启AP热点。
配网失败。 a. 路由器密码失败,配网超时失败。 b. 三元组数据不是对应产品生产的,服务器连接认证失败。即MQTT未能连接。 c. 连接云时,域名的端口问题。即MQTT未能连接。 d. 产品不是APP登录云环境创建的。
- 设备未能连上MQTT。 a. 三元组数据不是对应产品生产的,服务器连接认证失败。即MQTT未能连接。 b. 连接云时,域名的端口问题。即MQTT未能连接。
- 设备未上报属性。 a. 当设备未上报属性时,可能是MCU程序未处理,也可能是模组处理时将上报的数据包丢失了(模组固件存在bug)。 b. 当设备未上报属性时,也可能是MCU处理上报逻辑的问题。 c. 当设备未上报属性时,也可能是MCU上报给模组时,数据包在通信过程中丢失了,模组无法将数据上报。
- 设备收到指令后未正确执行。 a. 当模组已收到指令,下发指令给MCU过着,有可能数据包丢失了,MCU无法接收到指令。 b. 当模组已接收到指令,下发指令给MCU时,MCU接收到,但MCU开发者并未处理对应物模型指令(有可能是没有该功能)。
- 强制升级失败。 a. 模组未介绍正确的协议数据。 b. 升级的版本号问题。 这些失败原因,可查询模组上报的错误码定位问题。
部署问题
Android打包机部署的问题:
使用sdkmanager下载SDK后找不到SDK中的文件。
解决方案: 使用 sdkmanager时加上--sdk_root=path 参数指定SDK的下载位置。
启动 iot-app-build-service 服务后收不到打包消息。
解决方法:检查conf/.env和iot-app-build-service.yml文件中的配置是否正确,addrs的服务地址是否正确。
- 打包过程中总是要输入git的账号密码。 解决方法:运行 git config --global credential.helper store 命令,然后用git拉取一下代码,输入账号密码后会长期保存。
iOS打包机部署过程中可能会出现的问题:
npm 报错 npm ERR! request to https://registry.npmjs.org/amfe-flexible failed, reason: unable to get local issuer certificate。
解决方法:运行命令 npm config set strict-ssl false。
- 打包过程中找不到证书。 解决方法: a. 双击一个mobileprovision文件。 b. 在图形界面上打开终端 运行 security list-keychains | xargs security list-keychains -s。 c. 打开钥匙串访问app,删除“自定钥匙串”下的所有钥匙串。
- 未过期的证书在钥匙串中显示不被信任。 解决方法:根据 https://www.jianshu.com/p/d1d82ffed554 操作,然后重启电脑。
问题排查方法
复现问题。
检查问题是否在特定情况下才出现,还是常规出现,定位复现的条件、流程。
定位分析问题。
网页通过控制台查看是否报错,根据报错信息定位问题。
日志排查。通过后端的服务日志、设备日志、服务器日志进行问题排查。
根据常见问题建议流程,进行问题定位。
解决问题。
根据定位的问题,寻找解决方案。
a. 通过帮助文档了解该模块具体功能及实现。
b. 通过常见问题看是否有对应的解决方案。
c. 如果是云平台的问题,可联系爱星物联客服反馈该问题。