Android 11下应用无法读取WhatsApp.Statuses文件夹内容如何解决

Android 11（API 级别 30）强制启用分区存储机制，废弃了原有的广域存储访问逻辑，即使你申请了READ_EXTERNAL_STORAGE权限，也无法直接读取其他应用在Android/media目录下的专属私有媒体文件，这就是升级targetSdkVersion到30后读取.Statuses文件夹返回空的核心原因。Android 10上生效的requestLegacyExternalStorage配置在API 30及以上版本会被系统忽略，无法继续兼容。

• 方案1：申请所有文件访问权限（MANAGE_EXTERNAL_STORAGE）
  这是适配成本最低的方案，适合核心功能依赖读取WhatsApp状态的应用，适配步骤如下：

  1. 在AndroidManifest.xml中添加权限声明：

  <!-- Android 11+ 全文件访问权限 -->
  <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
  <!-- 低版本兼容存储权限 -->
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" />
  

  2. 运行时引导用户跳转系统设置页授权：

  // 权限申请请求码可自行定义
  const val REQUEST_MANAGE_STORAGE = 1001
  
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R && !Environment.isExternalStorageManager()) {
      val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION)
      intent.data = Uri.parse("package:${packageName}")
      startActivityForResult(intent, REQUEST_MANAGE_STORAGE)
  }
  

  注意：如果应用需要上架Google Play，需要向官方证明全文件权限是应用核心功能必需的，不符合使用场景的申请会被拒审。

• 方案2：使用存储访问框架（SAF）引导用户授权指定目录
  不需要申请全文件权限，符合Google Play上架规范，适配步骤如下：

  1. 拉起系统文件选择器，引导用户主动选中/.Statuses目录授权：

  // SAF授权请求码可自行定义
  const val REQUEST_SAF_PERMISSION = 1002
  
  val intent = Intent(Intent.ACTION_OPEN_DOCUMENT_TREE)
  // 预先定位到.Statuses目录，减少用户操作路径
  intent.putExtra(
    DocumentsContract.EXTRA_INITIAL_URI, 
    Uri.parse("content://com.android.externalstorage.documents/tree/primary%3AAndroid%2Fmedia%2Fcom.whatsapp%2FWhatsApp%2FMedia%2F.Statuses")
  )
  startActivityForResult(intent, REQUEST_SAF_PERMISSION)
  

  2. 用户授权后拿到目录Uri，调用contentResolver.takePersistableUriPermission()持久化授权后，即可通过ContentResolver读取该目录下的所有文件，后续打开应用无需重复授权。

• 方案3：通过MediaStore查询公开状态文件
  不需要申请特殊权限，只适用于读取非隐藏的公开WhatsApp状态文件：WhatsApp的公开状态会被系统媒体扫描器收录到MediaStore，你可以通过查询媒体库筛选MIME类型为图片/视频、所属路径包含WhatsApp状态目录的文件即可，缺点是无法读取未被媒体库收录的隐藏状态文件。

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