鸿蒙 App 系统通知无法发送，该如何排查问题并解决问题？

Question

应用无法发送系统通知，用户无法接收到重要消息

Answer 1

排查系统通知无法发送的问题

1. 检查回执配置：

   • 确保回执服务器配置正确，包括回调地址、回调用户名和回调密钥等。
   • 商用CA证书是否有效，如果证书已过期，请及时更换。

2. 确认推送消息的接收情况：

   • 使用华为Push服务器提供的测试消息进行功能测试，检查回执服务器是否收到测试消息。

   • 检查回执状态码，常见状态码及其原因包括：

     • 成功送达（状态码0）
     • 应用未安装（状态码2）
     • Token不存在（状态码5）
     • 通知消息不展示（状态码6）
     • 非活跃设备（状态码10）
     • 其它错误（状态码15、22、27、31、51、102、144、151、155、156、158、188、191、256、259、261、262、264、265、268、269）

3. 处理常见状态码：

   • 应用未安装：如果发现应用不存在，表示设备可能已卸载该应用。
   • 通知消息不展示：检查用户是否关闭了设备上的系统通知总开关或应用的通知渠道开关
   • 非活跃设备：设备为非活跃设备，消息不进行下发。
   • 终端设备处于开机未解锁状态：用户重启终端设备后，点亮屏幕未解锁。
   • 消息频次限制：每天向某个设备上某个应用最多可发送3000条消息，超过3000条后当天无法再向该设备的该应用继续发送消息。

4. 其他可能原因：

   • 消息被拒绝：请更换消息体内容或URL
   • 卡片刷新次数达上限：建议做过滤处理减少无效推送
   • 实况窗通知更新被管控：系统内部设置角标异常。

5. 过滤处理：

   • 对状态码2、5、6、10进行过滤处理，减少对这些用户的无效推送。

解决系统通知无法发送的问题

1. 优化推送策略：

   • 精细化推送，尽量减少或避免全量用户的推送。
   • 如果消息内容中有符合服务与通讯类消息的内容，建议申请和接入消息自分类。

2. 接入消息自分类：

   • 根据通知消息分类标准，接入消息自分类，限制每个设备每天不超过3000条消息。

3. 检查回执配置：

   • 确保回执服务器配置正确，包括回调地址、回调用户名和回调密钥等。
   • 商用CA证书是否有效，如果证书已过期，请及时更换。

4. 测试和监控：

   • 使用华为Push服务器提供的测试消息进行功能测试，检查回执服务器是否收到测试消息。
   • 定期检查回执状态码，及时处理异常情况。

Answer 2

在鸿蒙（HarmonyOS）应用开发中，如果遇到系统通知无法发送的问题，可以按照以下步骤进行排查和解决：

1. 检查权限配置
   确保在config.json中声明了必要的权限，如通知权限。
   配置权限

   {
    "module": {
        "abilities": [
            {
                "name": "MainAbility",
                "permissions": [
                    "ohos.permission.POST_NOTIFICATION"
                ]
            }
        ]
    }
   }

2. 检查通知代码
   确保使用正确的代码发送通知。
   发送通知示例代码

   import ohos.aafwk.ability.AbilitySlice;
   import ohos.aafwk.content.Intent;
   import ohos.notification.NotificationRequest;
   import ohos.notification.NotificationHelper;
   import ohos.hiviewdfx.HiLog;
   import ohos.hiviewdfx.HiLogLabel;
   
   public class MainAbilitySlice extends AbilitySlice {
    private static final HiLogLabel LABEL = new HiLogLabel(HiLog.LOG_APP, 0x00201, "MY_TAG");
   
    @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
        sendNotification();
    }
   
    private void sendNotification() {
        try {
            NotificationRequest notificationRequest = new NotificationRequest(1001);
            notificationRequest.setContentText("This is a test notification");
            NotificationHelper.publishNotification(notificationRequest);
            HiLog.info(LABEL, "Notification sent successfully.");
        } catch (Exception e) {
            HiLog.error(LABEL, "Failed to send notification: " + e.getMessage());
        }
    }
   }

3. 检查错误日志
   通过日志检查通知发送过程中是否有异常信息。
4. 检查设备设置
   确保设备没有禁用应用的通知权限。
5. 检查通知配置
   确保通知渠道和其他配置项正确设置，特别是对于安卓设备的兼容性。
6. 检查应用前后台状态
   某些系统可能会限制后台应用发送通知，确保应用在前台或根据后台策略调整通知发送逻辑。
   通过以上步骤和示例代码，可以有效地排查并解决鸿蒙开发中系统通知无法发送的问题。

Answer 3

一、检查应用权限，确保通知权限已开启
二、检查应用配置、应用清单文件，确保在应用的配置文件、中正确声明了通知权限，检查是否有遗漏或错误的权限声明。
三、检查通知渠道配置，确保通知渠道已正确配置，检查是否为每个需要发送的通知类型都配置了相应的渠道。检查渠道设置，确保渠道是可见的。
四、检查API使用，使用正确的API，确保使用HarmonyOS SDK提供的NotificationRequest和NotificationManager等API来构建和发送通知，检查代码中是否有错误地使用或调用了API。
五、检查通知内容，确保通知内容无误，检查通知的标题、内容、图标等属性设置是否正确无误。
六、检查设备和系统设置，设备通知设置，系统策略。
七、检查应用和系统兼容性，检查应用版本，确保应用是最新版本，或者尝试更新到最新版本看是否能解决问题。检查系统兼容性、性列表或文档。