Android应用无法打开外部复制文件的权限问题求助

问题根源 #

从Android 10（API 29）开始，系统引入了**分区存储（Scoped Storage）**机制：

• 即使申请了READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限，应用默认仅能访问自身创建的文件、媒体文件（图片/音频/视频），无法直接通过绝对路径访问其他应用或外部文件管理器创建的非媒体文件（比如你的JSON凭证文件）。
• 你当前的权限申请代码只适配了Android 10之前的存储逻辑，无法突破分区存储的限制。

解决方案 #

方案1：使用存储访问框架（SAF）【推荐，适配所有Android 10+版本】 #

通过系统提供的文件选择器让用户主动选择文件，应用可获取文件的Uri权限，从而合法访问该文件。

代码实现（AndroidX 推荐方式）

// 初始化文件选择器的启动器
private ActivityResultLauncher<String[]> openDocumentLauncher = registerForActivityResult(
    new ActivityResultContracts.OpenDocument(),
    uri -> {
        if (uri != null) {
            // 读取文件内容
            try (InputStream inputStream = getContentResolver().openInputStream(uri)) {
                BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
                StringBuilder content = new StringBuilder();
                String line;
                while ((line = reader.readLine()) != null) {
                    content.append(line);
                }
                // 在这里处理读取到的文件内容
            } catch (IOException e) {
                e.printStackTrace();
            }

            // 可选：持久化Uri权限，重启应用后仍可访问该文件
            getContentResolver().takePersistableUriPermission(uri,
                    Intent.FLAG_GRANT_READ_URI_PERMISSION);
        }
    }
);

// 调用此方法打开文件选择器
private void selectExternalFile() {
    // 指定允许选择的文件类型，这里以JSON为例
    openDocumentLauncher.launch(new String[]{"application/json"});
}

方案2：Android 10 过渡方案（不推荐长期使用） #

如果你的应用仅针对Android 10（API 29），可以在AndroidManifest.xml的<application>标签中添加以下属性，暂时禁用分区存储：

<application
    ...
    android:requestLegacyExternalStorage="true">
    ...
</application>

注意：该属性在Android 11（API 30）及以上版本无效，且不符合Google Play的长期适配要求。

方案3：Android 11+ 特殊权限（仅适用于文件管理器类应用） #

如果你的应用是文件管理器类，需要批量访问所有文件，可以申请MANAGE_EXTERNAL_STORAGE权限：

1. 在AndroidManifest.xml中添加权限：

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="30" />

2. 代码中引导用户到设置页开启权限：

if (!Environment.isExternalStorageManager()) {
    Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
    intent.setData(Uri.parse("package:" + getPackageName()));
    startActivity(intent);
}

注意：此权限属于特殊权限，Google Play审核会严格限制，仅对确实需要全文件访问的应用开放。

关键注意事项 #

• 避免直接使用绝对路径（如new File("/sdcard/xxx.json")）访问外部文件，分区存储下这种方式会被系统拒绝。
• 使用SAF时，无需申请READ_EXTERNAL_STORAGE权限，因为用户主动选择文件即代表授权。

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