Android Download Manager设置setNotificationVisibility为隐藏时无法下载怎么办

1. 核心权限适配问题（最常见触发场景） #

Android 12（API 级别 31）及以上系统中，调用setNotificationVisibility(DownloadManager.Request.VISIBILITY_HIDDEN)隐藏下载通知时，必须在AndroidManifest.xml中声明专属权限，否则DownloadManager会直接拒绝执行下载任务：

<uses-permission android:name="android.permission.DOWNLOAD_WITHOUT_NOTIFICATION" />

注意：低于API 31的系统默认不需要该权限即可隐藏通知，权限只需在清单文件静态声明即可正常生效，不需要动态申请。

2. 次要排查点 #

如果已经声明权限仍然无法下载，请依次检查以下配置：

• 检查你设置的隐藏常量是否正确，必须使用官方常量DownloadManager.Request.VISIBILITY_HIDDEN，不要手动传入数值2（部分定制ROM可能修改常量映射导致识别错误）
• 检查下载路径是否为DownloadManager可访问的公共目录，建议使用setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, "你的目标文件名")配置存储路径
• 检查是否同时设置了setAllowedOverMetered()、setAllowedOverRoaming()等网络限制参数，确认当前网络环境符合你设置的下载条件

3. 兼容性降级方案 #

如果部分定制ROM对特殊权限拦截较严格，无法正常使用隐藏通知的下载功能，可以改用如下兼容方案：
保留通知可见性为VISIBILITY_VISIBLE，但通过通知渠道设置将下载通知的优先级设为最低，隐藏状态栏图标和通知弹窗：

// Android 8.0及以上创建低优先级通知渠道
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    NotificationChannel channel = new NotificationChannel("download_channel", "下载通知", NotificationManager.IMPORTANCE_MIN);
    channel.setShowBadge(false);
    channel.enableVibration(false);
    channel.enableLights(false);
    NotificationManager notificationManager = getSystemService(NotificationManager.class);
    notificationManager.createNotificationChannel(channel);
}
// 下载请求绑定该渠道
request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE);
request.setNotificationChannel("download_channel");

该方案可以实现视觉上隐藏下载通知的效果，同时不需要申请特殊权限，兼容性更强。

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