Android中使用java.io.File遇exists()返回false问题求助

问题原因 #

通过Intent.ACTION_OPEN_DOCUMENT_TREE获取的content://开头的URI是Android文档提供器的抽象路径，并非真实的文件系统路径。java.io.File只能识别传统的文件系统路径（如/storage/emulated/0/Download/Repo），无法解析content://格式的URI，因此调用exists()会返回false。

解决方案：将SAF树URI转换为真实文件系统路径 #

步骤1：解析树URI的文档ID #

从获取到的URI中提取文档ID，分割为存储卷ID和相对路径：

import android.provider.DocumentsContract;

// uri为通过ACTION_OPEN_DOCUMENT_TREE获取的content URI
String documentId = DocumentsContract.getTreeDocumentId(uri);
// 按":"分割，分离存储卷ID与相对路径（仅分割1次）
String[] parts = documentId.split(":", 2);
if (parts.length != 2) {
    // 处理异常情况
    return null;
}
String volumeId = parts[0];
String relativePath = parts[1];

步骤2：获取存储卷的真实路径 #

通过StorageManager获取对应存储卷的根目录，拼接相对路径得到完整真实路径：

import android.content.Context;
import android.os.storage.StorageManager;
import android.os.storage.StorageVolume;

StorageManager storageManager = (StorageManager) getSystemService(Context.STORAGE_SERVICE);
StorageVolume storageVolume = storageManager.getStorageVolume(uri);
if (storageVolume == null) {
    return null;
}
// 获取存储卷的根目录文件
File volumeRoot = storageVolume.getDirectory();
// 拼接得到目标目录的真实File对象
File targetDir = new File(volumeRoot, relativePath);

步骤3：验证并使用 #

此时targetDir.exists()会返回true，可直接将该File对象传入JGit的API中使用。

注意事项 #

• 权限适配：Android 10及以上版本，针对Download这类公共目录，通过SAF获取URI后无需额外申请READ_EXTERNAL_STORAGE权限即可访问真实路径；若涉及应用私有目录或SD卡非公共目录，需确保已获得对应访问权限。
• 兼容性：该方法适用于内置存储和外置SD卡，通过StorageVolume获取根目录可避免硬编码路径导致的设备兼容性问题。

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