使用ACTION_OPEN_DOCUMENT_TREE授权后仍遇权限拒绝问题求助

核心原因 #

1. 手动拼接的文件URI不具备合法权限
   通过ACTION_OPEN_DOCUMENT_TREE获取的是目录级权限，但你手动拼接的子文件URI（如content://com.android.externalstorage.documents/document/primary%3AAndroid%2Fdata%2F...）并未关联目录的权限。系统的ExternalStorageProvider仅认可通过合法API（如DocumentFile遍历）生成的子文件URI，手动构造的路径不会被纳入权限覆盖范围。

2. 第三方应用无访问权限
   当你用ACTION_VIEW打开文件时，实际是由第三方应用（如图片查看器）去读取该URI。你的应用持有的目录权限无法自动传递给第三方应用，系统会直接拦截这种未授权的访问请求。

3. ACTION_OPEN_DOCUMENT_TREE权限范围限制
   该API授予的权限仅对通过DocumentFile.fromTreeUri()遍历得到的子文件/目录URI有效，任何脱离这个流程构造的URI，都会被系统判定为未通过ACTION_OPEN_DOCUMENT等合规API获取访问权限，从而抛出SecurityException。

解决步骤 #

1. 通过DocumentFile获取合法的子文件URI
   不要手动拼接路径，而是从已授权的目录URI派生子文件URI：

// treeUri 是你从ACTION_OPEN_DOCUMENT_TREE获取的目录URI
DocumentFile treeDoc = DocumentFile.fromTreeUri(context, treeUri);
// 逐层定位到目标文件
DocumentFile targetFile = treeDoc.findFile("Android")
        .findFile("data")
        .findFile("com.example.app")
        .findFile("files")
        .findFile("20230830.3a0d57cd-bd7d-2a5e-27e5-7723c4b21160.png");

if (targetFile != null) {
    Uri validFileUri = targetFile.getUri();
    // 使用这个validFileUri进行后续操作
}

2. 启动ACTION_VIEW时临时授予权限
   在启动第三方应用的Intent中添加权限标记，将你的应用持有的读权限临时授予对方：

Intent viewIntent = new Intent(Intent.ACTION_VIEW);
viewIntent.setDataAndType(validFileUri, "image/png");
// 添加临时权限标记
viewIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
context.startActivity(viewIntent);

额外注意 #

Android 11及以上版本中，Android/data/目录属于应用专属存储区域，即使通过ACTION_OPEN_DOCUMENT_TREE获取权限，部分系统版本仍会对该区域的访问有额外限制。如果遇到这种情况，建议优先考虑将文件存储到公共目录，或使用应用内部存储。

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