Android 11下React Native编辑指定文件遇权限拒绝的解决方案

针对Android 11的Scoped Storage限制，直接访问/storage/emulated/0/note/my_note.txt这类公共自定义目录会触发权限拒绝，以下是几种可行的解决思路：

方案一：通过存储访问框架（SAF）获取用户授权 #

这是Scoped Storage规范下的标准解决方案，需要引导用户手动选择目标文件以获取读写权限：

1. 安装支持SAF的库，比如react-native-document-picker：

   npm install react-native-document-picker
   

2. 在代码中实现文件选择与读写：

   import DocumentPicker from 'react-native-document-picker';
   import RNFS from 'react-native-fs';
   
   // 选择目标文件
   const pickAndEditNote = async () => {
     try {
       const res = await DocumentPicker.pick({
         type: [DocumentPicker.types.allFiles],
       });
       // 读取文件内容
       const content = await RNFS.readFile(res.uri, 'utf8');
       // 修改后写入（部分库支持直接通过URI写入，若RNFS不行可改用react-native-scoped-storage的writeFile方法）
       await RNFS.writeFile(res.uri, '修改后的内容', 'utf8');
     } catch (err) {
       if (!DocumentPicker.isCancel(err)) {
         console.error('操作失败:', err);
       }
     }
   };
   

方案二：迁移至应用专属存储目录 #

如果业务允许调整文件存储位置，将文件移至应用私有目录可绕过Scoped Storage限制，无需额外权限：

import RNFS from 'react-native-fs';

// 应用专属目录路径
const appNotePath = `${RNFS.DocumentDirectoryPath}/my_note.txt`;

// 读取文件
const readNote = async () => {
  const content = await RNFS.readFile(appNotePath, 'utf8');
};

// 写入文件
const writeNote = async (content) => {
  await RNFS.writeFile(appNotePath, content, 'utf8');
};

注意：应用专属目录下的文件无法通过系统文件管理器直接查看，若需要用户可见性，需额外配置文件共享逻辑。

方案三：自定义原生模块处理SAF读写 #

如果现成库无法满足需求，可自行编写Android原生模块实现SAF的文件读写：

1. 原生模块读取示例：

   @ReactMethod
   public void readFileFromUri(String uriString, Promise promise) {
     try {
       Uri uri = Uri.parse(uriString);
       InputStream inputStream = getReactApplicationContext().getContentResolver().openInputStream(uri);
       BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
       StringBuilder content = new StringBuilder();
       String line;
       while ((line = reader.readLine()) != null) {
         content.append(line).append("\n");
       }
       inputStream.close();
       promise.resolve(content.toString());
     } catch (Exception e) {
       promise.reject("READ_ERROR", e.getMessage());
     }
   }
   

2. 原生模块写入示例：

   @ReactMethod
   public void writeFileToUri(String uriString, String content, Promise promise) {
     try {
       Uri uri = Uri.parse(uriString);
       OutputStream outputStream = getReactApplicationContext().getContentResolver().openOutputStream(uri);
       outputStream.write(content.getBytes());
       outputStream.close();
       promise.resolve("写入成功");
     } catch (Exception e) {
       promise.reject("WRITE_ERROR", e.getMessage());
     }
   }
   

3. React Native端调用：

   import { NativeModules } from 'react-native';
   const { SAFFileModule } = NativeModules;
   
   const editFileViaSAF = async (uri) => {
     try {
       const content = await SAFFileModule.readFileFromUri(uri);
       await SAFFileModule.writeFileToUri(uri, content + "\n新增内容");
     } catch (err) {
       console.error(err);
     }
   };
   

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