Android应用扫描含PDF URI的QR码无法打开问题求助

核心问题：Android URI临时授权机制 #

你遇到的现象本质是Android文件访问的权限限制：

• 当你通过filePickerLauncher（比如ActivityResultContracts.OpenDocument）选择文件时，系统会自动给你的App授予该content:// URI的临时读写权限（通过Intent.FLAG_GRANT_READ_URI_PERMISSION），这个权限会保留到App重启或主动释放，所以后续扫描相同URI时能正常访问。
• 直接扫描得到的content:// URI，你的App没有对应的访问权限，Android沙箱会阻止你读取该文件，而如果你的代码没有做错误捕获，就会表现为“无任何反应”。

具体解决方案 #

1. 避免在QR码中使用content:// URI #

content:// URI是系统临时生成的、带权限绑定的标识，不适合作为长期共享的路径。建议改用：

• 文件名+固定存储目录（比如Downloads或Documents），App内部拼接成可访问的路径；
• 自定义的文件唯一标识（比如文件MD5），App通过标识在本地存储中查找对应文件。

注意：Android 10+启用了分区存储，直接访问外部存储路径需要MANAGE_EXTERNAL_STORAGE权限（需在应用商店说明用途），或者使用MediaStore API访问媒体文件。

2. 给扫描后的URI添加权限处理 #

如果必须使用content:// URI，可按以下方式处理：

• 在扫描到URI后，引导用户通过文件选择器再次选择对应文件，获取临时权限；
• 给打开PDF的代码添加错误捕获，打印异常日志定位问题，示例代码：

fun openPdf(uri: Uri) {
    try {
        contentResolver.openInputStream(uri)?.use { inputStream ->
            // 处理PDF打开逻辑，比如用第三方PDF库或系统Intent打开
            val intent = Intent(Intent.ACTION_VIEW).apply {
                setDataAndType(uri, "application/pdf")
                addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION) // 必须添加这个Flag
            }
            startActivity(intent)
        }
    } catch (e: SecurityException) {
        // 权限不足，提示用户选择文件
        Toast.makeText(this, "请先通过文件选择器选择该PDF", Toast.LENGTH_SHORT).show()
        // 启动文件选择器
        filePickerLauncher.launch(arrayOf("application/pdf"))
    } catch (e: Exception) {
        e.printStackTrace()
        Toast.makeText(this, "打开PDF失败", Toast.LENGTH_SHORT).show()
    }
}

注意：即使添加FLAG_GRANT_READ_URI_PERMISSION，如果App没有该URI的权限，仍然会抛出SecurityException，所以必须捕获处理。

3. 检查文件打开逻辑的权限传递 #

如果是通过系统Intent打开PDF，必须给Intent添加Intent.FLAG_GRANT_READ_URI_PERMISSION，否则接收Intent的第三方PDF应用也没有权限访问该URI，导致打开失败。

新手调试建议 #

• 在Android Studio的Logcat中搜索SecurityException或FileNotFoundException，查看扫描URI时的具体错误信息；
• 测试时，先扫描URI，再查看App的权限状态（设置→应用→你的App→权限），确认是否有文件访问权限。

内容的提问来源于stack exchange，提问作者Darius da costa