React Native安卓11/12可读取目录但无法读取WhatsApp状态文件求助

问题核心原因 #

你遇到的空数组问题主要是两个点：

1. 路径错误：你定义的WhatsAppStatusDir2指向了WhatsApp Images目录，而Android 11+的WhatsApp状态文件实际仍然存放在.Statuses子目录下，只是整个媒体目录迁移到了Android/media/com.whatsapp路径下。
2. 分区存储限制：Android 11+强制启用分区存储（Scoped Storage），直接通过react-native-fs访问其他应用的私有媒体目录会被系统限制，即使申请了常规读写权限也无法获取文件列表。

分步解决方案 #

1. 修正状态目录路径 #

首先把Android 11+的路径指向正确的.Statuses目录：

let StatusDir = null;
// Android 10及以下的传统路径
const WhatsAppStatusDirLegacy = `${RNFS.ExternalStorageDirectoryPath}/WhatsApp/Media/.Statuses`;
// Android 11+的正确路径
const WhatsAppStatusDirScoped = `${RNFS.ExternalStorageDirectoryPath}/Android/media/com.whatsapp/WhatsApp/Media/.Statuses`;

const statusDirExists1 = await RNFS.exists(WhatsAppStatusDirLegacy);
const statusDirExists2 = await RNFS.exists(WhatsAppStatusDirScoped);
if (statusDirExists1) {
  StatusDir = WhatsAppStatusDirLegacy;
} else if (statusDirExists2) {
  StatusDir = WhatsAppStatusDirScoped;
}

2. 用MediaStore API替代直接文件读取 #

分区存储下，必须通过系统的MediaStore API查询其他应用共享的媒体文件，推荐使用react-native-media-store库来实现：

安装依赖

npm install react-native-media-store

查询WhatsApp状态文件

import MediaStore from 'react-native-media-store';

const fetchStatusFiles = async () => {
  try {
    // 查询所有WhatsApp状态目录下的图片和视频
    const mediaFiles = await MediaStore.getFiles({
      mediaType: 'all',
      sort: { column: 'date_added', order: 'DESC' }, // 按时间倒序，最新状态在前
      where: [
        {
          column: 'relative_path',
          operator: 'LIKE',
          value: '%WhatsApp/Media/.Statuses/%'
        }
      ]
    });
    console.log('获取到的状态文件：', mediaFiles);
    return mediaFiles;
  } catch (err) {
    console.error('查询状态文件失败：', err);
  }
};

3. 适配不同Android版本的权限配置 #

在AndroidManifest.xml中添加对应权限：

<!-- Android 10及以下 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" />

<!-- Android 11-12 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

<!-- Android 13+ -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

代码中动态申请权限

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

const requestMediaPermissions = async () => {
  const permissions = [];
  if (Platform.Version >= 33) {
    permissions.push(
      PermissionsAndroid.PERMISSIONS.READ_MEDIA_IMAGES,
      PermissionsAndroid.PERMISSIONS.READ_MEDIA_VIDEO
    );
  } else if (Platform.Version >= 30) {
    permissions.push(PermissionsAndroid.PERMISSIONS.READ_EXTERNAL_STORAGE);
  } else {
    permissions.push(
      PermissionsAndroid.PERMISSIONS.READ_EXTERNAL_STORAGE,
      PermissionsAndroid.PERMISSIONS.WRITE_EXTERNAL_STORAGE
    );
  }

  const grantResults = await PermissionsAndroid.requestMultiple(permissions);
  return Object.values(grantResults).every(res => res === PermissionsAndroid.RESULTS.GRANTED);
};

4. 特殊权限（不推荐） #

如果你必须使用react-native-fs直接读取文件，需要申请MANAGE_EXTERNAL_STORAGE权限，但这个权限属于特殊权限，Google Play会严格审核，仅允许文件管理器类应用使用：

• 在AndroidManifest.xml中添加权限：

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

• 代码中引导用户手动开启权限：

  import { Linking, Platform } from 'react-native';
  
  const openStorageSettings = () => {
    if (Platform.OS === 'android') {
      Linking.openSettings();
    }
  };
  

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