Android 14中DownloadManager抛出SecurityException问题排查

问题背景 #

捕获到如下崩溃堆栈：

Fatal Exception: java.lang.SecurityException: Unsupported path /storage/emulated/0/Download
   at android.os.Parcel.createExceptionOrNull(Parcel.java:3023)
   at android.os.Parcel.createException(Parcel.java:3007)
   at android.os.Parcel.readException(Parcel.java:2990)
   at android.database.DatabaseUtils.readExceptionFromParcel(DatabaseUtils.java:190)
   at android.database.DatabaseUtils.readExceptionFromParcel(DatabaseUtils.java:142)
   at android.content.ContentProviderProxy.insert(ContentProviderNative.java:557)
   at android.content.ContentResolver.insert(ContentResolver.java:2200)
   at android.content.ContentResolver.insert(ContentResolver.java:2162)
   at android.app.DownloadManager.enqueue(DownloadManager.java:1582)

下载任务配置如下：

val request = DownloadManager.Request(Uri.parse(downloadUrl))
            .apply {
                setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, downloadFilename)
                // ...
            }

根据官方文档，setDestinationInExternalPublicDir操作无需申请存储权限，但仍在多设备/Android版本上出现崩溃，且无法在测试设备复现，需排查可能的用户设置原因。

可能的用户设置原因 #

• 外部存储被手动禁用或挂载异常：部分设备允许用户在系统设置中禁用外部存储（包括模拟的内部存储分区），或者存储介质出现挂载故障，导致系统无法识别/storage/emulated/0/Download路径，触发权限异常。
• 定制ROM下的额外存储限制：部分厂商定制ROM会对系统API做权限增强，即便官方文档说明无需权限，用户仍可能在隐私设置中手动关闭了应用的存储权限，或通过系统隐私工具限制了应用对公共目录的访问。
• 公共Download目录属性被修改：用户可能通过第三方文件管理器、存储清理工具修改了Download目录的权限（如设为只读）、所有者或目录结构，导致DownloadManager无法正常写入。
• 多用户/工作资料模式限制：当设备处于多用户账户或工作资料（Android for Work）模式时，当前用户可能没有访问公共Download目录的权限——尤其是工作账户通常被限制访问个人存储区域。
• 存储加密异常：设备开启全盘加密后，若加密过程中断或出现故障，会导致存储目录无法正常访问，系统返回“路径不支持”的错误。

临时修复建议 #

捕获该SecurityException后，可尝试切换到应用私有外部存储路径作为备选方案：

val fallbackDir = context.getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS)
fallbackDir?.let {
    request.setDestinationUri(Uri.fromFile(File(it, downloadFilename)))
}

内容的提问来源于stack exchange，提问作者david.mihola