Android 10+设备无法直接打开WhatsApp .Statuses文件夹问题

问题根源 #

硬编码的Documents URI（如content://com.android.externalstorage.documents/tree/primary%3AAndroid%2Fmedia%2Fcom.whatsapp%2FWhatsApp%2FMedia%2F.Statuses）存在以下缺陷：

• 不同OEM厂商的系统可能修改外部存储的DocumentsProvider结构，导致硬编码路径不通用
• .Statuses是隐藏文件夹，部分系统的文件选择器不支持直接通过初始URI跳转至隐藏目录
• 直接拼接的URI未经过系统验证，易触发IllegalArgumentException且 fallback 逻辑失效

解决方案 #

1. 动态构建目标文件夹的树URI #

通过逐步导航的方式定位到WhatsApp Media目录，再查找.Statuses子文件夹，最后转换为系统可识别的树URI，避免硬编码路径的兼容性问题。

2. 优化选择器引导逻辑 #

如果无法动态定位到.Statuses，自动 fallback 到WhatsApp Media目录，若仍失败则打开外部存储根目录，同时可引导用户手动开启"显示隐藏文件"选项。

修改后的代码实现 #

首先添加辅助方法用于动态获取目标文件夹URI：

private fun getWhatsAppStatusTreeUri(): Uri? {
    // 获取外部存储根目录的DocumentFile
    val externalRoot = DocumentFile.fromTreeUri(this, Uri.parse("content://com.android.externalstorage.documents/tree/primary%3A"))
    externalRoot ?: return null

    // 逐步导航到WhatsApp Media目录
    val androidDir = externalRoot.findFile("Android")
    val mediaDir = androidDir?.findFile("media")
    val whatsappDir = mediaDir?.findFile("com.whatsapp")
    val whatsAppMediaRoot = whatsappDir?.findFile("WhatsApp")?.findFile("Media")

    // 定位.Statuses隐藏文件夹
    val statusDir = whatsAppMediaRoot?.findFile(".Statuses")

    // 将DocumentFile转换为树URI
    return statusDir?.let {
        DocumentsContract.buildDocumentUriUsingTree(
            Uri.parse("content://com.android.externalstorage.documents/tree/primary%3A"),
            DocumentsContract.getDocumentId(it.uri)
        )
    } ?: whatsAppMediaRoot?.let {
        DocumentsContract.buildDocumentUriUsingTree(
            Uri.parse("content://com.android.externalstorage.documents/tree/primary%3A"),
            DocumentsContract.getDocumentId(it.uri)
        )
    }
}

然后重写getWhatsAppStatusesAboveQ方法：

private fun getWhatsAppStatusesAboveQ() {
    val intent = Intent(Intent.ACTION_OPEN_DOCUMENT_TREE)
    val targetUri = getWhatsAppStatusTreeUri()

    targetUri?.let {
        try {
            intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, it)
        } catch (e: IllegalArgumentException) {
            // 目标URI无效时，fallback到WhatsApp Media目录
            val fallbackUri = Uri.parse("content://com.android.externalstorage.documents/tree/primary%3AAndroid%2Fmedia%2Fcom.whatsapp%2FWhatsApp%2FMedia")
            intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, fallbackUri)
        }
    } ?: run {
        // 无法定位任何目录时，打开外部存储根目录
        intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, Uri.parse("content://com.android.externalstorage.documents/tree/primary%3A"))
    }

    startActivityForResult(intent, REQUEST_CODE_OPEN_DOCUMENT_TREE)
}

额外优化建议 #

• 调用文件选择器前，添加提示告知用户需开启"显示隐藏文件"选项（多数系统文件选择器支持该功能）
• 对于Android 11+，若应用属于文件管理类，可考虑申请MANAGE_EXTERNAL_STORAGE权限，但需注意该权限需在应用商店说明用途
• 保存用户选择的URI时，验证其是否指向.Statuses目录，避免后续读取错误

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