Android SDK26+使用NotificationCompat.Builder发通知无提示音故障求助

问题核心原因及修复方案 #

1. 最常见踩坑点：通知通道属性缓存 #

Android 8.0（SDK26）及以上版本中，通知通道一旦首次创建成功，除通道名称、描述外的所有配置（铃声、振动模式、重要等级、音频属性等）都会被系统永久保留，后续代码修改不会生效。你之前测试时大概率已经用相同channelId创建过通道，后续调整的声音、振动相关配置都没有被系统应用。

• 临时测试解决方案：完全卸载当前应用清除旧通道缓存，或者手动进入系统应用设置-通知，删除该应用的所有通知通道后重新测试。
• 调试阶段可以在创建通道前先删除旧通道（正式上线请勿使用，会清空用户对通道的自定义配置）：

// 仅调试阶段使用，上线请移除
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    notificationManager.deleteNotificationChannel(channelId);
}

2. 音频属性配置错误 #

你当前设置的AudioAttributes内容类型错误，CONTENT_TYPE_MUSIC会让通知铃声走媒体音量通道而非通知音量通道，如果媒体音量为静音就会听不到提示音，修改为通知类专用的内容类型即可：

final AudioAttributes att = new AudioAttributes.Builder()
        .setUsage(AudioAttributes.USAGE_NOTIFICATION)
        .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION) // 替换原CONTENT_TYPE_MUSIC
        .build();

3. 可选校验项 #

可以在发送通知前增加权限校验，避免被系统拦截：

NotificationManagerCompat notificationManager = NotificationManagerCompat.from(context);
// 校验总通知开关是否开启
if (!notificationManager.areNotificationsEnabled()) {
    // 引导用户开启通知权限
    return;
}
// 校验对应通道是否未被静音
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    NotificationChannel channel = notificationManager.getNotificationChannel(channelId);
    if (channel != null && channel.getImportance() == NotificationManager.IMPORTANCE_NONE) {
        // 通道被用户手动禁用，引导用户开启
        return;
    }
}

4. 冗余代码清理 #

NotificationCompat.Builder构造方法已经传入了channelId，后续不需要重复调用setChannelId(channelId)，删除该行即可不影响功能。

内容的提问来源于stack exchange，提问作者John Doe