Android使用Intent.ACTION_GET_CONTENT时ES文件浏览器触发SecurityException

问题原因 #

• 权限传递不规范：默认文件管理器、合规第三方应用（如Quickpic）在返回content://类型Uri时，会自动为调用方附加临时读取权限（通过Intent.FLAG_GRANT_READ_URI_PERMISSION）。但ES文件浏览器未遵循Android权限传递规范，没有为返回的Uri添加权限标志，导致你的应用尝试打开文件流时被系统拦截，抛出SecurityException。
• MIUI权限管控叠加限制：在MIUI 14（Android 12）的自定义权限策略下，ES文件浏览器的跨应用权限传递可能被额外限制，即便Uri格式正确，系统也不允许你的应用访问对应资源。

兼容方案（无需申请文件权限） #

1. 改用官方推荐的存储访问框架（SAF）Intent #

替换ACTION_GET_CONTENT为ACTION_OPEN_DOCUMENT，这是Android 4.3+引入的标准文件选择API，针对跨应用文件访问做了完善的权限处理，绝大多数第三方应用会适配该接口的权限传递规则。同时指定文件类型，减少不必要的适配问题。

2. 显式添加权限标志 #

创建Intent时主动添加FLAG_GRANT_READ_URI_PERMISSION，确保接收Uri的应用能获得临时读取权限。

3. 捕获异常做兼容处理 #

针对老旧/不合规的第三方应用，捕获SecurityException，提示用户切换到默认文件选择器。

4. 可选：持久化权限（如需长期访问文件） #

如果需要在应用重启后仍能访问目标文件，可调用contentResolver.takePersistableUriPermission获取持久权限。

修改后的测试代码 #

注册ActivityResultLauncher #

mPickResultLauncher = registerForActivityResult(
    ActivityResultContracts.StartActivityForResult()
) { result ->
    if (result.resultCode == RESULT_OK) {
        val uri = result.data?.data ?: return@registerForActivityResult
        Log.d(TAG, "selectFile: $uri")

        // 尝试获取持久权限（按需启用）
        try {
            contentResolver.takePersistableUriPermission(
                uri,
                Intent.FLAG_GRANT_READ_URI_PERMISSION
            )
        } catch (e: SecurityException) {
            Log.w(TAG, "无法获取持久权限: ${e.message}")
        }

        // 打开文件并处理异常
        try {
            contentResolver.openInputStream(uri)?.use {
                val bytes = it.readBytes()
                Log.d(TAG, "selectFile: ${bytes.size}")
            }
        } catch (e: SecurityException) {
            Log.e(TAG, "读取文件失败: ${e.message}")
            // 提示用户切换到默认文件选择器
            // Toast.makeText(this, "文件读取失败，请使用默认文件管理器选择", Toast.LENGTH_SHORT).show()
        }
    }
}

启动文件选择器的方法 #

private fun selectFile() {
    val intent = Intent(Intent.ACTION_OPEN_DOCUMENT).apply {
        // 指定文件类型，以图片为例，可按需修改
        type = "image/*"
        // 显式添加读取权限标志
        addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
        // 可选：允许选择多个文件
        // putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true)
    }
    mPickResultLauncher.launch(intent)
}

基础&扩展知识 #

1. Android文件访问核心方式 #

• MediaStore：用于访问系统媒体库的图片、视频、音频等文件，对应Uri格式为content://media/external/...，合规应用会通过MediaStore正确传递权限。
• 存储访问框架（SAF）：通过ACTION_OPEN_DOCUMENT/ACTION_CREATE_DOCUMENT等Intent调用，支持访问所有类型文件，还提供持久化权限能力，是官方推荐的跨应用文件访问方案。

2. 临时权限与持久权限 #

• 临时权限：ACTION_GET_CONTENT返回的Uri权限仅在当前应用进程生命周期内有效，重启应用后失效。
• 持久权限：通过ACTION_OPEN_DOCUMENT获取Uri后，调用takePersistableUriPermission可将权限持久化，即便应用或设备重启，仍能访问目标文件。

3. 第三方应用适配注意事项 #

• 部分老旧第三方文件管理器未遵循SAF规范，存在权限传递问题，此时只能通过异常捕获引导用户使用合规应用。
• Android 10及以上版本中，READ_EXTERNAL_STORAGE权限仅能访问MediaStore文件，无法直接访问其他目录，因此SAF是更可靠的跨应用文件访问方式。

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