React Native如何处理全文件访问及MANAGE_EXTERNAL_STORAGE权限问题？

我之前也踩过Android 11存储权限的坑，这个版本的权限机制变化确实给不少开发者带来了麻烦。下面是一步步的解决方案，帮你搞定这个问题：

1. 配置AndroidManifest.xml权限 #

首先在android/app/src/main/AndroidManifest.xml里添加必要的权限声明：

<!-- 兼容Android 10及以下版本的写入权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" />
<!-- Android 11+专属的全文件访问权限 -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
<!-- 可选：如果需要读取其他应用的文件，添加此权限 -->
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />

另外，如果之前为了兼容Android 10加了android:requestLegacyExternalStorage="true"，可以保留，但Android 11+会自动忽略这个属性。

2. 在React Native中申请特殊权限 #

MANAGE_EXTERNAL_STORAGE是系统特殊权限，不能用普通的PermissionsAndroid API申请，必须引导用户到系统设置页面手动开启。这里提供两种实现方式：

方式一：自定义原生模块（Kotlin示例） #

在Android项目里写个简单的原生模块，提供权限检查和跳转设置的方法：

// FileAccessModule.kt
package com.yourappname

import android.content.Intent
import android.net.Uri
import android.os.Build
import android.provider.Settings
import android.os.Environment
import com.facebook.react.bridge.ReactApplicationContext
import com.facebook.react.bridge.ReactContextBaseJavaModule
import com.facebook.react.bridge.ReactMethod

class FileAccessModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
    override fun getName(): String = "FileAccessModule"

    @ReactMethod
    fun checkManageStoragePermission(): Boolean {
        return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            Environment.isExternalStorageManager()
        } else {
            true // Android 10及以下已通过WRITE_EXTERNAL_STORAGE处理，默认返回已授权
        }
    }

    @ReactMethod
    fun openManageStorageSettings() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION)
            intent.data = Uri.parse("package:${reactApplicationContext.packageName}")
            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
            reactApplicationContext.startActivity(intent)
        }
    }
}

然后在MainApplication.kt里注册这个模块：

override fun getPackages(): List<ReactPackage> {
    return listOf(
        // ...其他已有的包
        object : ReactPackage {
            override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
                return listOf(FileAccessModule(reactContext))
            }

            override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
                return emptyList()
            }
        }
    )
}

回到React Native代码里调用：

import { NativeModules } from 'react-native';
const { FileAccessModule } = NativeModules;

// 检查权限并引导授权
const handleStoragePermission = async () => {
    const hasPermission = await FileAccessModule.checkManageStoragePermission();
    if (!hasPermission) {
        alert('需要开启全文件访问权限才能保存文件，请在设置中开启');
        FileAccessModule.openManageStorageSettings();
    }
};

方式二：使用第三方库 #

不想写原生代码的话，可以用react-native-permissions（版本需≥3.0.0），它已经支持MANAGE_EXTERNAL_STORAGE权限的检查：

import { check, request, PERMISSIONS, RESULTS } from 'react-native-permissions';
import { Platform, Alert } from 'react-native';

const checkStoragePermission = async () => {
    if (Platform.OS !== 'android') return;

    if (Platform.Version >= 30) {
        const result = await check(PERMISSIONS.ANDROID.MANAGE_EXTERNAL_STORAGE);
        if (result === RESULTS.DENIED) {
            Alert.alert('权限提示', '需要开启全文件访问权限才能保存文件', [
                { text: '取消' },
                { text: '去设置', onPress: () => request(PERMISSIONS.ANDROID.MANAGE_EXTERNAL_STORAGE) }
            ]);
        }
    } else {
        // 处理Android 10及以下的WRITE_EXTERNAL_STORAGE权限
        const result = await check(PERMISSIONS.ANDROID.WRITE_EXTERNAL_STORAGE);
        if (result === RESULTS.DENIED) {
            await request(PERMISSIONS.ANDROID.WRITE_EXTERNAL_STORAGE);
        }
    }
};

3. 适配文件写入逻辑 #

拿到权限后，还要确保文件写入代码适配Android 11+：

• 如果你用旧的File API直接操作公共目录（比如Downloads），在有MANAGE_EXTERNAL_STORAGE权限后可以继续使用，但要注意Google Play的审核限制。
• 更推荐的方式是使用MediaStore API写入公共目录，这种方式不需要MANAGE_EXTERNAL_STORAGE权限，也符合Google的存储政策。你可以在原生模块中实现MediaStore写入逻辑，或者使用支持该特性的第三方库（比如react-native-fs的最新版本）。

比如用react-native-fs写入Downloads目录的示例：

import RNFS from 'react-native-fs';

// 写入PDF文件到Downloads目录（假设文件内容是base64格式）
const saveFileToDownloads = async (base64Content, fileName) => {
    const targetPath = `${RNFS.DownloadDirectoryPath}/${fileName}`;
    await RNFS.writeFile(targetPath, base64Content, 'base64');
    alert(`文件已保存到：${targetPath}`);
};

4. 重要提醒：Google Play审核政策 #

MANAGE_EXTERNAL_STORAGE是敏感权限，Google Play只允许特定类型的应用使用，比如文件管理器、备份恢复工具、反病毒软件等。如果你的应用不属于这类，建议优先用MediaStore或应用专属存储（getExternalFilesDir()），这样既不需要申请特殊权限，也能避免审核被拒。

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