React Native Android 13（API 33）下文件无法默认保存至下载目录的问题求助

我来帮你分析下这个问题，结合Android 13的权限特性和React Native的API使用逻辑，你的代码里有几个容易踩的坑，下面给你具体的排查和解决方案：

问题核心原因分析 #

你的需求是把文件保存到系统公共Downloads目录（用户能在文件管理器直接看到的那个），但当前代码存在几个适配问题：

1. 误用了MANAGE_EXTERNAL_STORAGE特殊权限：Android 13完全不需要这个权限来访问公共Downloads目录，反而这个权限需要用户手动去设置里开启，大部分用户不会操作，直接导致流程卡住
2. RNFS路径指向错误：默认的RNFS.DownloadDirectoryPath在Android 10+指向的是应用私有Download目录（用户看不到），而非系统公共目录
3. Share API的调用逻辑冗余：你已经手动把文件移动到Download目录，不需要再通过Share.open的saveToFiles参数重复触发保存
4. 权限配置未适配Android 13的权限废弃规则

具体解决方案 #

1. 简化权限逻辑（移除不必要的高权限） #

Android 13（API33）针对公共Downloads目录的写入，不需要WRITE_EXTERNAL_STORAGE或MANAGE_EXTERNAL_STORAGE权限，仅对API 29及以下版本保留传统权限请求即可：

const handleAndroidFileSaving = useCallback(async (filePath: string, title: string, document: IDocumentDTO) => {
  try {
    if (Platform.OS === 'android') {
      // 仅针对Android 10（API29）及以下版本请求写入权限
      if (Platform.Version < 30) {
        const granted = await PermissionsAndroid.request(
          PermissionsAndroid.PERMISSIONS.WRITE_EXTERNAL_STORAGE,
          {
            title: 'Permiso de almacenamiento',
            message: 'La app necesita acceso al almacenamiento para guardar archivos',
            buttonPositive: 'Aceptar',
          }
        );
        if (granted !== PermissionsAndroid.RESULTS.GRANTED) {
          throw new Error('Permiso de almacenamiento denegado');
        }
      }
      // API30+ 无需任何存储权限
    }
    // 后续代码...
  } catch (error) {
    console.error('Error guardando archivo:', error);
    showGlobalAlert('Error al guardar el archivo', 'error');
  }
}, [showGlobalAlert]);

同时更新AndroidManifest.xml的权限配置，适配版本规则：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 仅对API29及以下版本生效 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" />
<!-- 仅对API32及以下版本生效 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

<application
  ...
  <!-- 兼容Android 10+的Scoped Storage，允许访问公共存储目录 -->
  android:requestLegacyExternalStorage="true">
  ...
</application>

2. 修正路径指向系统公共Downloads目录 #

替换RNFS的路径为系统公共Download目录的真实路径，确保用户能在文件管理器看到保存的文件：

// 系统公共Downloads目录的正确路径
const publicDownloadsPath = `${RNFS.ExternalStorageDirectoryPath}/Download/${title}`;

// 检查目标文件是否已存在，避免覆盖
if (await RNFS.exists(publicDownloadsPath)) {
  const timestamp = Date.now();
  const [fileName, extension] = title.split('.');
  publicDownloadsPath = `${RNFS.ExternalStorageDirectoryPath}/Download/${fileName}_${timestamp}.${extension}`;
}

// 移动文件到公共Download目录
await RNFS.moveFile(filePath, publicDownloadsPath);
// 设置文件权限，确保其他应用（比如文件管理器）能访问
await RNFS.chmod(publicDownloadsPath, 0o666);

3. 优化Share API的使用逻辑 #

既然已经把文件移动到公共Download目录，不需要再通过Share API触发保存，直接通知用户即可；如果需要让用户选择分享或打开文件，可以简化Share调用：

// 文件保存成功后直接提示用户
showGlobalAlert('Archivo guardado en la carpeta Descargas', 'success');

// 可选：如果需要让用户操作文件，延迟调用Share
setTimeout(async () => {
  try {
    await Share.open({
      url: `file://${publicDownloadsPath}`,
      type: document.type,
      failOnCancel: false,
    });
  } catch (shareError) {
    console.error('Error al compartir archivo:', shareError);
  }
}, DELAY);

4. 调试排查建议 #

1. 打印publicDownloadsPath的实际值，确认是/storage/emulated/0/Download/xxx格式（系统公共目录）
2. 用await RNFS.exists(publicDownloadsPath)检查文件是否真的被移动到目标路径
3. 查看Android Studio的Logcat日志，排查是否有文件访问权限的报错
4. 确保react-native-fs是最新版本，避免版本兼容问题

完整修正后的代码示例 #

import RNFS from 'react-native-fs';
import { PermissionsAndroid, Platform, Share } from 'react-native';

const DELAY = 1000;

const handleAndroidFileSaving = useCallback(async (filePath: string, title: string, document: IDocumentDTO) => {
  try {
    if (Platform.OS === 'android') {
      if (Platform.Version < 30) {
        const granted = await PermissionsAndroid.request(
          PermissionsAndroid.PERMISSIONS.WRITE_EXTERNAL_STORAGE,
          {
            title: 'Permiso de almacenamiento',
            message: 'La app necesita acceso al almacenamiento para guardar archivos',
            buttonPositive: 'Aceptar',
          }
        );
        if (granted !== PermissionsAndroid.RESULTS.GRANTED) {
          throw new Error('Permiso de almacenamiento denegado');
        }
      }
    }

    // 系统公共Downloads目录路径
    let publicDownloadsPath = `${RNFS.ExternalStorageDirectoryPath}/Download/${title}`;
    
    // 避免覆盖已存在的文件
    if (await RNFS.exists(publicDownloadsPath)) {
      const timestamp = Date.now();
      const [fileName, extension] = title.split('.');
      publicDownloadsPath = `${RNFS.ExternalStorageDirectoryPath}/Download/${fileName}_${timestamp}.${extension}`;
    }

    // 移动文件并设置权限
    await RNFS.moveFile(filePath, publicDownloadsPath);
    await RNFS.chmod(publicDownloadsPath, 0o666);

    // 确认文件保存成功
    if (await RNFS.exists(publicDownloadsPath)) {
      showGlobalAlert('Archivo guardado en Descargas', 'success');
      // 可选：触发分享/打开操作
      setTimeout(async () => {
        await Share.open({
          url: `file://${publicDownloadsPath}`,
          type: document.type,
          failOnCancel: false,
        });
      }, DELAY);
    } else {
      throw new Error('No se pudo verificar el archivo guardado');
    }
  } catch (error) {
    console.error('Error guardando archivo:', error);
    showGlobalAlert('Error al guardar el archivo', 'error');
  }
}, [showGlobalAlert]);

内容来源于stack exchange