React Native外部存储权限弹窗不显示问题求助

核心原因分析 #

Android从API 29（Android 10）开始引入分区存储机制，WRITE_EXTERNAL_STORAGE权限的行为发生了本质变化：

• API 29及以上：系统默认授予媒体文件读写权限，不会弹出权限申请弹窗
• API 30（Android 11）及以上：WRITE_EXTERNAL_STORAGE权限被废弃，完全访问外部存储需要申请MANAGE_EXTERNAL_STORAGE权限，且该权限无法通过代码弹窗申请，必须引导用户到应用设置手动开启

具体解决方案 #

1. 调整AndroidManifest.xml配置 #

• 针对API 29，添加android:requestLegacyExternalStorage="true"到<application>标签，兼容旧存储模型：

  <application
    android:name=".MainApplication"
    android:label="@string/app_name"
    android:icon="@mipmap/ic_launcher"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:allowBackup="false"
    android:theme="@style/AppTheme"
    android:requestLegacyExternalStorage="true"> <!-- 新增该行 -->
    <!-- 其他内容保持不变 -->
  </application>
  

• 针对API 30+，添加全存储访问权限：

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

2. 修改权限申请逻辑 #

根据Android版本动态处理权限，替换原downloadFile函数：

import { Platform } from 'react-native';

const downloadFile = async () => {
  try {
    let granted = false;
    const sdkVersion = Platform.Version;

    if (sdkVersion < 29) {
      // Android 9及以下，申请WRITE_EXTERNAL_STORAGE
      granted = await PermissionsAndroid.request(
        PermissionsAndroid.PERMISSIONS.WRITE_EXTERNAL_STORAGE,
        {
          title: 'Spardha App存储权限',
          message: 'Spardha App需要访问存储以下载文件',
          buttonNeutral: '稍后询问',
          buttonNegative: '取消',
          buttonPositive: '确定',
        },
      );
      granted = granted === PermissionsAndroid.RESULTS.GRANTED;
    } else if (sdkVersion === 29) {
      // Android 10，系统默认授予媒体权限，直接执行下载
      granted = true;
    } else {
      // Android 11+，检查是否有全存储访问权限
      granted = await PermissionsAndroid.check(PermissionsAndroid.PERMISSIONS.MANAGE_EXTERNAL_STORAGE);
      if (!granted) {
        // 引导用户到设置页面开启权限
        Alert.alert(
          '需要存储权限',
          '请在应用设置中开启"所有文件访问权限"以完成下载',
          [
            { text: '取消', style: 'cancel' },
            { text: '去设置', onPress: () => PermissionsAndroid.openSettings() },
          ],
        );
        return;
      }
    }

    if (granted) {
      actualDownload();
    } else {
      Alert.alert(
        '权限被拒绝',
        '你需要授予存储权限才能下载文件',
      );
    }
  } catch (err) {
    console.warn(err);
  }
};

3. 优化RNFetchBlob下载配置 #

确保下载路径符合分区存储规则，利用系统DownloadManager简化权限处理：

const actualDownload = () => {
  const { config, fs } = RNFetchBlob;
  const date = new Date();
  const fileName = `download_${Math.floor(date.getDate() + date.getSeconds() / 2)}.pdf`;
  
  config({
    fileCache: false, // 使用系统DownloadManager时无需本地缓存
    addAndroidDownloads: {
      useDownloadManager: true,
      notification: true,
      description: "下载文件",
      path: `${fs.dirs.DownloadDir}/${fileName}`,
      mediaScannable: true, // 让下载文件能被系统媒体库识别
    }
  })
    .fetch('GET', 'https://www.africau.edu/images/default/sample.pdf', {})
    .then(res => {
      console.log('文件已保存到 ', res.path());
    })
    .catch(e => {
      console.log(e);
    });
};

额外注意事项 #

• 测试前需清理应用缓存或卸载重装，确保权限配置生效
• Android 13+可优先使用READ_MEDIA_IMAGES等细粒度权限，替代全存储访问权限以符合隐私规范

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