Android如何访问隐藏文件？WhatsApp隐藏.Statuses目录文件列表获取失败解决方案咨询

阿华AIGC实验室

2026-4-30

解决Android访问WhatsApp隐藏.Statuses文件夹返回空的问题

你猜的没错，隐藏文件夹本身其实不是listFiles()返回空的核心原因——listFiles()默认是会包含隐藏文件的。真正的问题出在Android版本的存储权限限制，尤其是Android 10（API 29）及以上的分区存储机制，直接通过绝对路径访问WhatsApp的私有媒体目录会被系统拦截。下面分情况给你具体的解决方案：

一、先确认权限是否到位

不管哪个Android版本，首先要确保你已经申请了READ_EXTERNAL_STORAGE权限，并且用户已经授权：

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

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

在代码中动态申请权限（Android 6.0+必须动态授权）：

if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 100);
}

二、针对不同Android版本的解决方案

1. Android 9及以下（API 28及更低）

这个版本没有分区存储限制，只要权限到位，你可以直接用File类访问，甚至不需要额外处理隐藏文件——不过为了保险，你可以显式指定过滤器确保包含隐藏文件：

File folder = new File(Environment.getExternalStorageDirectory().getAbsolutePath() + "/Android/media/com.whatsapp/WhatsApp/Media/.Statuses");
// 显式接受所有文件（包括隐藏文件）
File[] files = folder.listFiles(file -> true);
if (files != null) {
    // 这里就能拿到所有5个文件了
    for (File file : files) {
        Log.d("StatusFile", file.getName());
    }
}

2. Android 10（API 29）

这个版本引入了分区存储，但你可以通过临时兼容开关绕过：
在AndroidManifest.xml的application标签中添加：

<application
    ...
    android:requestLegacyExternalStorage="true">
    ...
</application>

添加后，你就可以用上面Android 9的代码正常访问了。不过注意这个开关在Android 11+会失效。

3. Android 11及以上（API 30+）

这个版本强制启用分区存储，绝对不能再用File类直接访问其他应用的私有目录，必须使用MediaStore API来查询WhatsApp的状态文件：
状态文件要么是图片要么是视频，我们可以通过MediaStore筛选出路径包含WhatsApp/Media/.Statuses的文件：

ContentResolver contentResolver = getContentResolver();

// 查询图片类型的状态文件
Uri imageUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
String[] projection = {
        MediaStore.Images.Media._ID,
        MediaStore.Images.Media.DISPLAY_NAME,
        MediaStore.Images.Media.RELATIVE_PATH
};
// 筛选路径包含目标文件夹的文件
String selection = MediaStore.Images.Media.RELATIVE_PATH + " LIKE ?";
String[] selectionArgs = new String[]{"%WhatsApp/Media/.Statuses%"};

Cursor imageCursor = contentResolver.query(imageUri, projection, selection, selectionArgs, null);
if (imageCursor != null) {
    while (imageCursor.moveToNext()) {
        String fileName = imageCursor.getString(imageCursor.getColumnIndexOrThrow(MediaStore.Images.Media.DISPLAY_NAME));
        long fileId = imageCursor.getLong(imageCursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID));
        // 通过ID获取文件的Uri，用于后续访问（比如打开输入流）
        Uri fileUri = ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, fileId);
        Log.d("StatusImage", "文件名：" + fileName + "，Uri：" + fileUri);
    }
    imageCursor.close();
}

// 同理查询视频类型的状态文件
Uri videoUri = MediaStore.Video.Media.EXTERNAL_CONTENT_URI;
Cursor videoCursor = contentResolver.query(videoUri, projection, selection, selectionArgs, null);
// 后续处理和图片逻辑一致，这里省略
if (videoCursor != null) {
    // ...
    videoCursor.close();
}