Android 11下Media Store API无法访问WhatsApp状态文件夹求助

核心原因 #

WhatsApp的状态文件夹是隐藏目录（路径为Android/media/com.whatsapp/WhatsApp/Media/.Statuses），Android 11的Media Store默认不会索引隐藏目录下的媒体文件；同时Android 11的存储权限模型对应用访问外部存储有更严格的限制。

具体解决方案 #

1. 声明必要权限 #

在AndroidManifest.xml中添加权限：

<!-- Android 10及以下的媒体访问权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- Android 11及以上需添加，用于访问其他应用的媒体目录 -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="30" />

注意：MANAGE_EXTERNAL_STORAGE是特殊权限，需引导用户到系统设置手动开启，代码示例：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    if (!Environment.isExternalStorageManager()) {
        val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION)
        intent.data = Uri.parse("package:" + context.packageName)
        startActivity(intent)
    }
}

2. 直接访问隐藏目录（绕过Media Store） #

由于Media Store默认不扫描隐藏文件夹，可通过文件路径直接访问：

val statusDir = File(
    Environment.getExternalStorageDirectory(),
    "Android/media/com.whatsapp/WhatsApp/Media/.Statuses"
)

if (statusDir.exists() && statusDir.isDirectory) {
    val statusFiles = statusDir.listFiles()
    // 处理获取到的状态文件
}

此方式必须依赖MANAGE_EXTERNAL_STORAGE权限，因为Android 11下应用无法直接访问其他应用的私有目录（隐藏目录不在Media Store索引范围内）。

3. 关于Media Store扫描隐藏目录的说明 #

尝试发送广播请求Media Store扫描指定目录的方式可靠性极低，Android 11对广播限制较严，系统大概率会忽略对隐藏目录的扫描请求，不推荐使用。

4. 注意WhatsApp的目录变动 #

部分WhatsApp版本会将状态文件存储在Android/data/com.whatsapp/files/WhatsApp/Media/.Statuses，这是应用私有目录，Android 11下其他应用无法直接访问，且Media Store也不会索引该隐藏目录，此路径下的文件无合法访问途径。

关键提示 #

• Android 11中，READ_EXTERNAL_STORAGE仅能访问Media Store已索引的文件，无法触及隐藏目录或其他应用的私有目录。
• MANAGE_EXTERNAL_STORAGE权限需用户手动授权，且Google Play对使用该权限的应用有严格审核标准，仅适用于文件管理器类场景。

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