Android NotificationManager创建通知频道超限问题及解决方案咨询

触发异常 #

java.lang.IllegalStateException: Limit exceed; cannot create more channels

问题原因：代码中错误使用System.currentTimeMillis()作为通知频道ID，每次发送通知都会创建全新频道，而Android系统对通知频道数量存在上限，超出后触发该异常。

可行解决方案 #

1. 清理已生成的无效频道 #

可通过NotificationManager删除错误逻辑生成的频道，操作步骤如下：

• 获取所有已注册的通知频道
• 筛选出ID为时间戳格式（纯数字字符串）的无效频道
• 逐一删除这些频道

示例代码：

NotificationManager notificationManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
if (notificationManager != null && Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    List<NotificationChannel> allChannels = notificationManager.getNotificationChannels();
    for (NotificationChannel channel : allChannels) {
        try {
            // 判断频道ID是否为时间戳格式的数字字符串
            Long.parseLong(channel.getId());
            notificationManager.deleteNotificationChannel(channel.getId());
        } catch (NumberFormatException ignored) {
            // 跳过非时间戳ID的有效频道
        }
    }
}

注意：删除频道后，用户对这些频道的自定义设置会被清除且无法恢复。

2. 修复核心逻辑：使用固定频道ID #

这是避免再次触发问题的根本方法，将动态生成的时间戳ID替换为固定字符串ID，建议从资源文件中读取：

修改频道ID生成代码：

// 替换原动态生成ID的逻辑，使用固定资源ID
String channelId = AndroidVersionUtils.isOreoOrMore() 
    ? context.getString(R.string.main_notification_channel_id) 
    : context.getString(R.string.app_name);

在res/values/strings.xml中添加固定频道ID：

<string name="main_notification_channel_id">app_core_notification_channel</string>

3. 优化频道创建逻辑 #

在创建频道前先检查是否已存在，避免重复创建操作：

NotificationManager mNotificationManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O && mNotificationManager != null) {
    // 检查目标频道是否已存在
    NotificationChannel existingChannel = mNotificationManager.getNotificationChannel(channelId);
    if (existingChannel == null) {
        // 仅当频道不存在时才执行创建逻辑
        NotificationChannel mChannel = new NotificationChannel(channelId, title, NotificationManager.IMPORTANCE_HIGH);
        mChannel.setLightColor(Color.GRAY);
        mChannel.enableLights(true);
        mChannel.setDescription(content);
        AudioAttributes audioAttributes = new AudioAttributes.Builder()
                .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
                .setUsage(AudioAttributes.USAGE_NOTIFICATION)
                .build();
        mChannel.setSound(uri, audioAttributes);
        mNotificationManager.createNotificationChannel(mChannel);
    }
}

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