Android 14下带点文件夹/.nomedia导致无法读取文件的解决求助

问题根源 #

Android 10（API 29）引入的Scoped Storage机制，对公共存储目录的访问做了严格限制：

• 名称以.开头的文件夹会被系统标记为"隐藏"，传统File API在无特殊权限时无法读取其中内容
• 添加.nomedia文件后，媒体扫描器会忽略该文件夹，但同时也会限制普通File API的访问（尤其是Android 13/14）

最优解决方案：使用应用专属外部存储目录 #

这是Android官方推荐的方案，无需额外权限，文件默认不会被图库扫描，且APP可自由读写：

修改你的getPathThumbnail()方法，改用应用专属存储目录：

public File getPathThumbnail() {
    // 获取APP专属的外部图片存储子目录，自动避开媒体扫描
    File baseDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    if (baseDir == null) {
        return null;
    }
    File dir = new File(baseDir, "AquaInfo/FileImages/Thumbnail");
    
    if (!dir.exists()) {
        boolean success = dir.mkdirs();
        if (!success) {
            dir = null;
        }
    }
    return dir;
}

方案优势：

• 无需申请READ_EXTERNAL_STORAGE/MANAGE_EXTERNAL_STORAGE等权限（Android 4.4+生效）
• 文件夹内的文件不会被系统媒体扫描器索引，图库完全看不到
• APP拥有完全的读写权限，卸载APP时该目录会被自动删除，无残留

备选方案：使用公共目录+存储访问框架(SAF) #

如果必须将文件放在公共目录（如Documents），可通过SAF获取文件夹的持久化访问权限，无需申请高风险的MANAGE_EXTERNAL_STORAGE权限：

1. 请求用户选择目标文件夹：

private static final int REQUEST_FOLDER_ACCESS = 100;

private void requestHiddenFolderAccess() {
    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
    startActivityForResult(intent, REQUEST_FOLDER_ACCESS);
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_FOLDER_ACCESS && resultCode == RESULT_OK) {
        if (data == null) return;
        
        Uri treeUri = data.getData();
        // 持久化访问权限，重启APP后依然有效
        getContentResolver().takePersistableUriPermission(treeUri,
                Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
        
        // 使用DocumentFile操作文件夹内的文件
        DocumentFile directory = DocumentFile.fromTreeUri(this, treeUri);
        if (directory != null) {
            // 读取匹配文件的示例
            DocumentFile[] matchingFiles = directory.listFiles(file -> 
                file.getName() != null && file.getName().startsWith(finalDesiredFileName)
            );
            // 后续处理逻辑...
        }
    }
}

2. 添加.nomedia文件阻止图库扫描：
   通过SAF在目标文件夹创建.nomedia文件：

if (directory != null) {
    directory.createFile("", ".nomedia");
}

不推荐方案：申请MANAGE_EXTERNAL_STORAGE权限 #

该权限允许APP访问所有外部存储文件，但属于高风险权限，Google Play审核会严格限制（仅允许文件管理器、备份类等特定类型应用使用），且需要用户手动在设置中开启：

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

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="30" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />

2. 请求权限：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    if (!Environment.isExternalStorageManager()) {
        Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
        Uri uri = Uri.fromParts("package", getPackageName(), null);
        intent.setData(uri);
        startActivity(intent);
    }
}

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