设备连接常见问题（持续更新）

1，设备蓝牙已经开启，FA无法连接设备

问题现象

手机蓝牙已经开启，手机FA无法通过蓝牙模块连接设备，而且设备连接FA会闪退。

可能原因

• 原因一：未配置ohos.permission.USE_BLUETOOTH权限。

• 原因二：获取的BluetoothHost对象有误。

解决措施

1. 确认工程entry下的“config.json”中的“reqPermissions”字段包含权限“ohos.permission.USE_BLUETOOTH”。

"reqPermissions": [  {    "name": "ohos.permission.USE_BLUETOOTH"  }]

 2.确认BluetoothHost对象获取正确，并且蓝牙已经打开。

// 获取蓝牙本机管理对象BluetoothHost mBluetoothHost = BluetoothHost.getDefaultHost(context);// 调用打开接口mBluetoothHost.enableBt();// 调用获取蓝牙开关状态接口int state = mBluetoothHost.getBtState(); 

2，设备配网过程中，配网FA获取不到Wi-Fi列表

问题现象

设备配网过程中，配网FA获取不到Wi-Fi列表。

可能原因

• 原因一：配网模块中没有注册“NetConfigAbility”。
• 原因二：不止一个配网模块注册了“NetConfigAbility”。

解决措施

1. 确认配网模块是否有注册“NetConfigAbility”。
   1. 在配网模块下，找到该模块下的“MainAbility”，双击打开。
   2. 检查该文件的onStart方法中是否含有NetConfigAbility.register()的代码。
2. 确认是否存在多个注册了“NetConfigAbility”的配网模块。
   1. 逐个排查各个配网模块“MainAbility”的onStart方法是否都注册了“NetConfigAbility”。
   2. 只在一个配网模块中保留“NetConfigAbility”的注册，删除其他配网模块“NetConfigAbility”的注册代码。

3，设备配网过程中，使用SoftAP的方式未扫描到设备

问题现象

设备配网过程中，使用SoftAP的方式未扫描到设备。

可能原因

• 原因一：Wi-Fi设备未开启。
• 原因二：Wi-Fi设备已开启，getWifiList接口读取的是Wi-Fi缓存信息。
• 原因三：NFC标签码流的MAC地址与Wi-Fi设备的MAC地址不一致。

解决措施

1. 确认Wi-Fi设备已开启。
2. 间隔一段时间（约2min）后，重新扫描设备。如果多次扫描仍提示配网失败，重试重置设备。

确认NFC标签码流的MAC地址是否与Wi-Fi设备的MAC地址一致。如果不一致，则需要重新烧录正确的NFC码流信息。

4，设备配网过程中，在SoftAP配网进度达30%时失败，显示“当前网络不可用”

问题现象

碰一碰拉起配网FA，在进行SoftAP配网时配网进度在30%失败，提示“当前网络不可用”。

可能原因

• 原因一：模组侧因长时间不启用进入待机状态，关闭了配网所需的设备AP。
• 原因二：NFC标签码流中0406字段后6字节写入的数据与设备开启的AP MAC地址不一致。

解决措施

1. 确保设备AP无线网络名称正确。
   1. 登录华为智能硬件合作伙伴平台，单击右上角的“管理中心”。
   2. 单击对应的产品，进入“集成开发”页面。在配网设置中查看并记录“无线网络名称”(SSID)的取值。
   3. 在手机中打开“设置”，选择“WLAN > 可用WLAN”，确保该列表中存在与记录的SSID相同的设备AP。
      • 若无相同SSID的设备AP，请尝试重启设备。
      • 若产品ID一致但SSID名称不一致，请重新烧录模组使SSID与记录的一致。
2. 修改标签码流MAC字段并重新烧录NFC。

5，手机碰一碰NFC标签，无法拉起FA，提示“发现NFC标签，点击启动应用”

问题现象

手机碰一碰待连接设备，NFC服务弹出提示“发现NFC标签，点击启动应用”，没有正常拉起原子化服务。

可能原因

NFC标签码流录入错误，导致手机系统无法正确解析NFC码流。

解决措施

1. 在Device Partner平台上申请NFC标签码流，并根据实际设备信息生成可用的标签码流。
2. 将码流重新写入NFC标签，并重试碰一碰拉起原子化服务。

6，手机碰一碰NFC标签，提示“系统错误”

问题现象

手机碰一碰待连接设备，弹框提示“系统错误”，更换Wi-Fi后报错仍无法清除。

可能原因

手机时间与网络时间不一致。

设备发起请求时，会将手机时间与设备激活码等信息传到云端。云端会对手机时间与网络时间的一致性进行校验，以确保请求的合法性。如果两者的时间差大于一小时，则请求无效。

解决措施

将手机的时间设置为“自动设置”，使手机与当前网络上的时间同步。以华为手机为例：

1. 进入手机“设置”。
2. 选择“ 系统和更新 > 日期和时间”。
3. 开启“自动设置”开关。

7，手机碰一碰NFC标签，提示“二维码读取失败”

问题现象

手机碰一碰NFC标签，提示“二维码读取失败”。

可能原因

• 原因一：NFC标签中写入的14字段值与设备的SN不一致。

• 原因二：NFC标签中写入的04字段值与设备的AP MAC不一致。

解决措施

1. 检查NFC标签中的14字段与设备的SN号是否一致。如果不一致，需要重新写入。
2. 检查NFC标签中的04字段与设备的AP MAC是否一致。如果不一致，需要重新写入。

8，手机碰一碰NFC标签，提示“未获取到应用信息”

问题现象

手机碰一碰NFC标签，提示“未获取到应用信息”。

可能原因

• 原因一：服务意图配置的HarmonyOS标签的产品型号不是当前的ProductID。
• 原因二：NFC标签写入的码流中的ProductID有误。
• 原因三：未在Device Partner平台申请测试权限。

解决措施

1. 确认服务意图配置的HarmonyOS标签的产品型号是否为当前的ProductID。
   1. 登录HarmonyOS服务开放平台。
   2. 在服务列表中找到对应的原子化服务，单击“编辑”。
   3. 选择“配置 > HarmonyOS标签”，确认设备标签中的“产品型号”是否正确。如果不正确，需要重新配置。
2. 确认NFC标签码流的ProductID字段是否正确。如果不正确，需要重新写入。
3. 确认已在Device Partner平台申请测试权限。

   a. 登录华为智能硬件合作伙伴平台。

   b. 选择“帐号 > 基本资料”，单击页面右上角的“申请测试权限”。如果显示“尚未申请测试权限”，单击“立即申请测试权限”。

9，手机碰一碰NFC标签，无法拉起本地FA，提示“查询失败，请稍后再试”

问题现象

调试原子化服务时，手机碰一碰NFC标签，无法拉起本地FA，提示“查询失败，请稍后再试”。

可能原因

• 原因一：未创建HarmonyOS测试服务，或已创建的测试服务的配置信息有误。

• 原因二：NFC标签写入的码流有误。

解决措施

1. 参考调试应用，确保已创建HarmonyOS测试服务，且服务信息、HarmonyOS标签、FA信息等均已配置正确。
2. 参考生成NFC标签，确保NFC标签写入的码流正确。

10，手机碰一碰NFC标签，无法进行NAN配网

问题现象

手机碰一碰NFC标签，无法进行NAN配网，FA日志中打印碰一碰Intent参数nanSessionId字段的值为“NAN_DEVICE_NOT_FOUND”。

可能原因

• 用于配网的模组不支持NAN配网。
• 手机与模组之间距离大于30cm。
• 上一次碰一碰拉起配网FA进行NAN配网未完成，模组的NAN通道将锁定一段时间。

解决措施

1. 咨询产品对应模组厂商，确认模组是否支持NAN配网。
2. 将手机靠近至模组30cm半径以内后重新碰一碰配网。
3. 等待模组日志打印以下信息时，即可进行NAN配网(x代表任意数字)。

Send: msgType[x] msgId[x] msgLen[x]

若模组日志打印显示以下信息，则表示当前模组只能进行SoftAP配网，请重启模组或重新烧录模组。

wait STA join AP

11，手机首次碰一碰NFC标签，拉起的是非配网FA页面

问题现象

手机首次碰一碰NFC标签，拉起的是非配网FA页面（比如控制FA页面）。

可能原因

• 原因一：服务意图配置的Ability名称不是配网FA页面的Ability名称。
• 原因二：原子化服务包中其他模块的Ability与配网FA的Ability重名，导致拉起的FA页面有误。

解决措施

1. 确认服务意图配置的“服务名”是否为配网FA的Ability名称。
   1. 登录HarmonyOS服务开放平台。
   2. 在服务列表中找到对应的原子化服务，单击“编辑”。
   3. 选择“配置 > FA信息”，确认配置方式中的“服务名”是否为配网FA的Ability名称。如果不正确，需要重新配置。
2. 确认其他模块Ability名称是否与配网FA的Ability重名。
   1. 在DevEco Studio项目下，逐个排查其他模块中的“src/main/config.json”文件。
   2. 在json文件中，找到“module/mainAbility”配置项，检查是否与配网FA的Ability同名。
   3. 找到并选中重名的Ability，单击右键，选择“Refactor > Rename”，重命名文件。

12，碰一碰拉起配网FA，在SoftAP配网进度达30%时，显示“连接失败”

问题现象

碰一碰拉起配网FA，在SoftAP配网进度达30%时，显示“连接失败”。

可能原因

设备未处于待配网状态。

解决措施

通过重置/重启等操作，确保设备处于待配网状态。

13，智慧生活App中自动出现设备弹框，是否利用了靠近发现能力？

不是。靠近发现与智慧生活App的设备发现功能的主要区别如下：

• 靠近发现是一种基于设备芯片的Wi-Fi或蓝牙广播的连接能力。只需将HarmonyOS手机靠近设备（距离大约在30cm以内），无需打开智慧生活App，即可发现设备并在手机上弹框。
• 智慧生活App的设备发现功能是基于智慧生活基础服务的。因此必须在打开智慧生活App之后，才能自动扫描待配网状态的设备（持续1min），发现设备后会在智慧生活App中自动弹框。

14，手机碰一碰NFC标签，无法拉起本地FA，提示“查询失败，请稍后再试”

问题现象

手机碰一碰NFC标签，无法拉起本地FA，提示“查询失败，请稍后再试”。

可能原因

• 原因一：调试阶段，在HarmonyOS服务开放平台使用创建“HarmonyOS测试服务”方式：已创建的测试服务的配置信息有误，或者本地未安装原子化服务，或者在本地安装原子化服务时，未勾选“Deploy Multi Hap Packages”。
• 原因二：调试阶段，在HarmonyOS服务开放平台使用“HarmonyOS服务”中的真机测试方式：真机测试配置信息有误，或者在进行真机测试配置之前，未创建分发配置。

• 原因三：NFC标签写入的码流有误。

解决措施

1. 调试阶段在HarmonyOS服务开放平台使用创建“HarmonyOS测试服务”方式。
   1. 参考调试应用，确保已创建HarmonyOS测试服务，且服务信息、HarmonyOS标签、FA信息等均已配置正确。
   2. 检查确认原子化服务已经推送并安装到调测手机。
   3. 在本地安装原子化服务之前，确保已经勾选“Deploy Multi Hap Packages”。

1. 调试阶段，在HarmonyOS服务开放平台使用“HarmonyOS服务”中的真机测试方式：
   1. 确保真机测试配置无误，参见真机测试配置。
   2. 在进行真机测试配置之前，确保已经进行分发配置，参见支持碰一碰NFC/蓝牙标签（绑定硬件设备）。
2. 确保NFC标签写入的码流正确，参见生成NFC标签。

15，手机碰一碰NFC标签，提示“未获取到应用信息”

问题现象

手机碰一碰NFC标签，提示“未获取到应用信息”。

可能原因

• 原因一：调测阶段，HarmonyOS测试服务中，服务意图配置的HarmonyOS标签的产品型号不是当前的ProductID，或者服务意图配置的FA信息填写不对。
• 原因二：调测阶段，已配置HarmonyOS测试服务后，测试有效期过期。
• 原因三：调测阶段，未在Device Partner平台申请测试权限。
• 原因四：NFC标签写入的码流中的ProductID有误。
• 原因五：原子化服务上架之后（审核通过，版本的审核状态为“已上架”），但未对服务进行订阅。

解决措施

1. 确认服务意图配置的HarmonyOS标签的产品型号是否为当前的ProductID。
   1. 登录HarmonyOS服务开放平台。
   2. 在服务列表中找到对应的HarmonyOS测试服务，单击“编辑”。
   3. 选择“配置 > HarmonyOS标签”，确认设备标签中的“产品型号”是否正确。如果不正确，需要重新配置。配置完成后，单击右上角“保存”。
   4. 选择“配置 > FA信息”，确认FA信息中的“App包名”、“模块名”和“服务名”是否正确。如果不正确，需要重新配置。配置完成后，单击右上角“保存”。

      参数	必填/选填	说明
      App名称	必填	入口原子化服务（即设备配网模块）config.json文件中的label字段取值。
      App包名	必填	config.json文件中的bundleName字段取值。
      模块名	必填	入口原子化服务（即设备配网模块）config.json文件中的moduleName字段取值。
      服务名	必填	入口原子化服务（即设备配网模块）config.json文件中的mainAbility字段取值。

   5. 选择“测试 > 原子化服务测试”，单击“开始测试准备”。
2. 测试有效期为七天，过期后需单击“重新准备测试”。
   1. 登录HarmonyOS服务开放平台。
   2. 在服务列表中找到对应的HarmonyOS测试服务，单击“编辑”。
   3. 选择“测试 > 原子化服务测试”，单击“重新准备测试”。
3. 确认已在Device Partner平台申请测试权限。

   a. 登录华为智能硬件合作伙伴平台。

   b. 选择“帐号 > 基本资料”，单击页面右上角的“申请测试权限”。如果显示“尚未申请测试权限”，单击“立即申请测试权限”。

4. 确认NFC标签码流的ProductID字段是否正确。如果不正确，需要重新写入。
5. 确认已上架的服务已经订阅意图。
   1. 登录HarmonyOS服务开放平台。
   2. 在服务列表中找到对应的原子化服务，单击“编辑”。
   3. 单击上面菜单的“服务包管理”选项。
   4. 提供入口服务的服务标识符给到华为技术接口人，为服务订阅所需意图。

16，智慧生活基础服务删除数据后，手机首次碰一碰拉起FA异常

问题描述

1. 智慧生活基础服务删除数据后，手机首次碰一碰拉起FA连接弹窗，弹窗中设备图片/设备名称/FA图标缺失。
2. 进入华为帐号登录页后，点击“华为帐号快捷登录”，出现如下现象：
   • 无法跳转到帐号授权页面，导致FA闪退。
   • 进入帐号授权页面，点击“授权”后无法跳转到配网页面，导致FA闪退。

可能原因

智慧生活基础服务删除数据后，手机首次碰一碰时，智慧生活基础服务会进行初始化操作，在初始化未完成前碰一碰拉起FA会导致以上异常现象。

解决措施

该现象属于智慧生活基础服务机制而非问题，若认证测试提出该问题可以申请豁免。

待智慧生活基础服务初始化完成后（实际所需时间与网络情况有关），重试碰一碰拉起FA，可以正常显示。

17，使用智慧生活App手动添加通信类型为“蓝牙BLE”的设备，出现Wi-Fi连接页面

问题现象

采用HarmonyOS Connect极小硬件方案（BLE）开发方案时，使用智慧生活App手动添加蓝牙设备，设备连接时出现“Wi-Fi连接页面”。

可能原因

• 原因一：在Device Partner平台“产品开发 > 集成开发 > 蓝牙广播设置 > 设备添加方式”中勾选了“开启PIN码校验”，该选项并不适用于蓝牙BLE设备。
• 原因二：在Device Partner平台“产品开发 > 产品定义 > 软硬件定义 > 软硬件规格”中通信模组选择“自选芯片/模组”时，填写的芯片型号与“已经认证模组”的全称一致，导致平台识别为Combo模组。

解决措施

1. 在Device Partner平台“产品开发 > 集成开发 > 蓝牙广播设置 > 设备添加方式”中，取消勾选“开启PIN码校验”。
2. 在Device Partner平台“产品开发 > 产品定义 > 软硬件定义 > 软硬件规格”中，通信模组选择“自选芯片/模组”时，修改芯片型号，确保该名称不是“已认证模组”的全称。