为什么使用DownloadManager下载PDF的代码可在API 30运行但API 27报错？

问题根因 #

你遇到的报错是典型的安卓系统存储权限版本适配问题：

• 安卓11（API 30）开始强制分区存储机制，使用DownloadManager写入公共Downloads目录无需申请存储权限，因此你的代码在API30设备上运行正常
• 安卓6.0（API23）到安卓10（API29）范围内，WRITE_EXTERNAL_STORAGE属于危险权限，需要同时完成静态声明和动态用户授权两个步骤才能正常使用，你的API27设备正好属于这个适配范围，未授权就调用写入逻辑就会抛出对应的SecurityException

修复步骤 #

1. 补充AndroidManifest.xml权限声明 #

添加分版本适配的存储权限，同时确认已添加网络权限：

<!-- 网络权限，下载必需 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 存储权限仅在API29及以下需要 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" />

2. 增加动态权限申请逻辑 #

在调用downloadPDF方法之前，先检查当前运行设备的系统版本：

• 如果运行在API >=30的设备上，可直接调用下载逻辑
• 如果运行在API 23~29的设备上，先检查是否已获得WRITE_EXTERNAL_STORAGE权限，未授权的话先向用户发起权限申请，用户同意后再执行下载逻辑
  以下是基于Activity Result API的权限申请示例代码：

// 注册权限申请回调
val requestStoragePermission = registerForActivityResult(ActivityResultContracts.RequestPermission()) { isGranted ->
    if (isGranted) {
        // 权限已授予，执行下载逻辑
        downloadPDF(pdfUrl, targetFileName)
    } else {
        // 用户拒绝权限，提示权限不足无法下载
        Toast.makeText(context, "需要存储权限才能下载文件", Toast.LENGTH_SHORT).show()
    }
}

// 调用下载前先校验权限
when {
    Build.VERSION.SDK_INT >= Build.VERSION_CODES.R -> {
        // API30及以上，直接下载
        downloadPDF(pdfUrl, targetFileName)
    }
    ContextCompat.checkSelfPermission(context, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED -> {
        // 已获得存储权限，直接下载
        downloadPDF(pdfUrl, targetFileName)
    }
    else -> {
        // 未授权，发起权限申请
        requestStoragePermission.launch(Manifest.permission.WRITE_EXTERNAL_STORAGE)
    }
}

3. 可选优化 #

你报错日志中的文件名包含空格，可对文件名做特殊字符转义处理，避免部分系统出现兼容性问题。

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