安卓内部存储文档目录保存文件权限被拒问题咨询

我太懂你的痛点了——用getFilesDir()存的文件藏在APP私有目录里，用户得翻半天甚至root才能找到，完全不符合“易获取”的需求；而碰DIRECTORY_DOCUMENTS又遭权限拒接，确实头疼。下面给你拆解问题，一步步搞定：

为什么DIRECTORY_DOCUMENTS会访问被拒？ #

核心是两个原因：

• 权限没到位：安卓6.0（API 23）及以上，访问公共存储目录光在Manifest里加权限没用，得动态申请读写权限。
• 分区存储限制：安卓10（API 29）及以上引入了分区存储，直接用File类操作公共Documents目录会被限制，得换MediaStore API来实现。

具体解决方案 #

第一步：先搞定权限（针对安卓6.0+） #

先在AndroidManifest.xml里声明基础权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32"/>

然后在Activity里动态申请权限：

private static final int REQUEST_STORAGE_PERMISSION = 100;

private void checkStoragePermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
            != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
                REQUEST_STORAGE_PERMISSION);
    } else {
        // 权限到手，开始存文件
        saveFileToDocuments();
    }
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_STORAGE_PERMISSION) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            saveFileToDocuments();
        } else {
            Toast.makeText(this, "需要存储权限才能保存文件到文档目录", Toast.LENGTH_SHORT).show();
        }
    }
}

第二步：根据安卓版本选存储方式 #

情况1：安卓9及以下（API ≤28）

直接用公共Documents目录路径，用户能在文件管理器的“文档”文件夹里一眼找到：

private void saveFileToDocuments() {
    File documentsDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS);
    File targetDir = new File(documentsDir, "你的自定义文件夹名");
    if (!targetDir.exists()) {
        targetDir.mkdirs();
    }
    // 写入文件示例
    File file = new File(targetDir, "test.txt");
    try (FileWriter writer = new FileWriter(file)) {
        writer.write("测试内容");
        Toast.makeText(this, "文件已保存到文档目录", Toast.LENGTH_SHORT).show();
    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(this, "保存失败", Toast.LENGTH_SHORT).show();
    }
}

情况2：安卓10及以上（API ≥29）

受分区存储限制，推荐用MediaStore API写入文件，这样文件会自动出现在系统“文档”应用里：

private void saveFileToDocuments() {
    ContentValues values = new ContentValues();
    values.put(MediaStore.MediaColumns.DISPLAY_NAME, "test.txt");
    values.put(MediaStore.MediaColumns.MIME_TYPE, "text/plain");
    values.put(MediaStore.MediaColumns.RELATIVE_PATH, Environment.DIRECTORY_DOCUMENTS + "/你的自定义文件夹名");

    Uri uri = getContentResolver().insert(MediaStore.Files.getContentUri("external"), values);
    if (uri != null) {
        try (OutputStream outputStream = getContentResolver().openOutputStream(uri)) {
            if (outputStream != null) {
                outputStream.write("测试内容".getBytes());
                Toast.makeText(this, "文件已保存到文档目录", Toast.LENGTH_SHORT).show();
            }
        } catch (IOException e) {
            e.printStackTrace();
            Toast.makeText(this, "保存失败", Toast.LENGTH_SHORT).show();
        }
    }
}

额外小提示 #

如果不想用公共Documents目录，也可以试试getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS)——这个是APP的外部存储私有目录，安卓10+不需要动态权限，用户能在文件管理器的Android/data/你的APP包名/documents里找到，虽然不如公共目录直接，但比getFilesDir()好访问多了。

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