通知订阅扩展能力常见问题
============

#### 问题现象

使用通知订阅能力，已使用[openSubscriptionSettings](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-notificationextensionsubscription#notificationextensionsubscriptionopensubscriptionsettings)接口完成通知授权和设备连接订阅，仍然无法在[onReceiveMessage](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-notificationsubscriberextensionability#onreceivemessage)中收到回调，该如何排查问题。

#### 解决方案

**onReceiveMessage未收到回调原因排查：**

*   检查点一、确认用户已通过手机中的穿戴应用程序与穿戴设备配对。可以在设置-星闪和蓝牙-已配对设备中查看穿戴设备配对状态。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5f/v3/MGPNZTY7QHms7dgF6JV5Tg/zh-cn_image_0000002628554622.png?HW-CC-KV=V1&HW-CC-Date=20260709T134335Z&HW-CC-Expire=86400&HW-CC-Sign=4677C6EE5570CD95B49FA3A0ED2DD5FA84895706DBB00BF33A5565D285920370 "点击放大")
    
    手机与穿戴设备配对有两种方式：
    
    1.  星闪和蓝牙-其他设备列表中选择设备，手动完成配对操作。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4a/v3/cwuJ39lgSqWF3qN6zG2HWA/zh-cn_image_0000002658913945.png?HW-CC-KV=V1&HW-CC-Date=20260709T134335Z&HW-CC-Expire=86400&HW-CC-Sign=ABAA76B25109066BDE3BB339C21CBC9540E646C74B1CDB0277E8D5A4DA0104EA "点击放大")
        
    2.  应用内使用[connection.pairDevice](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bluetooth-connection#connectionpairdevice)接口主动发起配对。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/dc/v3/Q4-fNwhrRjWgxFbgGtt19A/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T134335Z&HW-CC-Expire=86400&HW-CC-Sign=47BACB0E494D1FD7F7A72319EE5FD5422C085EA1F7AD1E4A34B149F4657ECAC6)
        
        支持[HFP](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/terminology#hfp)连接的设备，需保证HFP连接一直处于连接状态。
        
*   检查点二、确认已使用[openSubscriptionSettings](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-notificationextensionsubscription#notificationextensionsubscriptionopensubscriptionsettings)接口完成通知授权。
*   检查点三、确认使用[蓝牙模块](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/connectivity-kit-intro#蓝牙简介)接口与穿戴设备配对后获取的地址，通过[subscribe](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-notificationextensionsubscription#notificationextensionsubscriptionsubscribe)接口订阅通知。未订阅时[NotificationSubscriberExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-notificationsubscriberextensionability)无法收到onReceiveMessage回调。

**onReceiveMessage回调日志排查和断点调试：**

完成上述检查后请确认onReceiveMessage可以收到回调消息，需要注意的是：

1.  NotificationSubscriberExtensionAbility是[ExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-extensionability)运行在独立进程，IDE查看日志不能筛选当前主进程，需要选择“No fliters”。
2.  调试NotificationSubscriberExtensionAbility时，请参考[extension调试](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-debug-arkts-extension)。

**通知转发到穿戴设备：**

使用onReceiveMessage收到回调后，穿戴设备不会自动显示消息通知，需要应用自行开发相关代码，调用蓝牙等协议转发通知消息给穿戴设备。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1c/v3/KwD9kKlLTDiOHO6FQpd-qw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T134335Z&HW-CC-Expire=86400&HW-CC-Sign=795D471990AA37F40AEA95238DBCB230F1F5A92CC0B74D9A90140AC9C3B9CC08)

可参考官网示例：[传统蓝牙连接示例](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ion-subscriber-extension-ability-development-steps#传统蓝牙连接示例)。注：示例仅作流程参考。