Android存储访问框架下判断存储根目录及treeUri路径异常问题

我帮你排查了下当前代码的问题，核心痛点在于反射获取存储路径的逻辑不够可靠，以及依赖文件名校验根目录的方式容易出现误判。下面给你两种解决方案，分别对应「不需要转换为File路径的轻量判断」和「修复路径转换逻辑」：

方案1：直接通过TreeUri判断根目录与存储类型（推荐） #

其实SAF的TreeUri本身就包含了足够的信息，完全不需要转换成File路径来校验。我们可以直接解析DocumentsContract.getTreeDocumentId()返回的字符串：

• 内部存储根目录的docId格式是primary:（冒号后为空）
• 外部SD卡根目录的docId格式是[UUID]:（冒号后为空）

直接写两个工具方法判断：

import android.text.TextUtils;
import android.provider.DocumentsContract;

private static final String PRIMARY_VOLUME_NAME = "primary";

// 判断选中的目录是否是存储根目录
public boolean isRootStorageDirectory(Uri treeUri) {
    String docId = DocumentsContract.getTreeDocumentId(treeUri);
    String[] docParts = docId.split(":");
    // 根目录的特征是：split后有两部分，且第二部分为空
    return docParts.length == 2 && TextUtils.isEmpty(docParts[1]);
}

// 判断选中的存储是否是内部存储
public boolean isInternalStorage(Uri treeUri) {
    String docId = DocumentsContract.getTreeDocumentId(treeUri);
    String volumeId = docId.split(":")[0];
    return PRIMARY_VOLUME_NAME.equals(volumeId);
}

然后在onActivityResult里直接用这两个方法：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (resultCode == RESULT_OK && requestCode == 42) {
        Uri treeUri = data.getData();
        
        if (isRootStorageDirectory(treeUri)) {
            if (isInternalStorage(treeUri)) {
                // 用户选中了内部存储根目录，执行授权逻辑
            } else {
                // 用户选中了外部SD卡根目录，执行授权逻辑
            }
        } else {
            // 提示用户选择内部存储或SD卡的根目录
        }
    }
}

这种方式完全绕开了路径转换的坑，既可靠又高效，还能兼容云存储等非本地文件系统的情况。

方案2：修复FileUtil的路径转换逻辑（如果必须获取真实路径） #

如果你确实需要拿到真实的File路径，那得修复getVolumePath方法里的反射逻辑——之前的代码在遍历存储卷时，可能因为顺序问题或者UUID匹配逻辑错误，导致返回了错误的路径。下面是优化后的代码：

private static String getVolumePath(final String volumeId, Context context) {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
        return null;
    }
    StorageManager storageManager = (StorageManager) context.getSystemService(Context.STORAGE_SERVICE);
    
    try {
        // API 24+ 使用公开API替代反射，更稳定
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            for (StorageVolume volume : storageManager.getStorageVolumes()) {
                // 匹配内部存储
                if (PRIMARY_VOLUME_NAME.equals(volumeId) && volume.isPrimary()) {
                    return volume.getDirectory().getAbsolutePath();
                }
                // 匹配外部存储（通过UUID）
                String uuid = volume.getUuid();
                if (uuid != null && uuid.equals(volumeId)) {
                    return volume.getDirectory().getAbsolutePath();
                }
            }
        } else {
            // 旧版本用反射，但优化遍历逻辑
            Class<?> storageVolumeClazz = Class.forName("android.os.storage.StorageVolume");
            Method getVolumeList = storageManager.getClass().getMethod("getVolumeList");
            Method getUuid = storageVolumeClazz.getMethod("getUuid");
            Method getPath = storageVolumeClazz.getMethod("getPath");
            Method isPrimary = storageVolumeClazz.getMethod("isPrimary");
            
            Object[] volumes = (Object[]) getVolumeList.invoke(storageManager);
            for (Object volume : volumes) {
                boolean isPrimaryVolume = (Boolean) isPrimary.invoke(volume);
                // 优先匹配内部存储
                if (isPrimaryVolume && PRIMARY_VOLUME_NAME.equals(volumeId)) {
                    return (String) getPath.invoke(volume);
                }
                // 匹配外部存储的UUID
                String uuid = (String) getUuid.invoke(volume);
                if (uuid != null && uuid.equals(volumeId)) {
                    return (String) getPath.invoke(volume);
                }
            }
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
    return null;
}

为什么之前路径会出错？ #

你遇到的选中SD卡却返回/storage/sdcard0的问题，大概率是因为：

1. 反射遍历存储卷时，先匹配到了内部存储的路径，而外部存储的UUID没有正确匹配上；
2. 不同设备的存储路径命名不一定是sdcard0/sdcard1，硬编码依赖路径名本身就不可靠。

额外建议 #

• 尽量避免将SAF的TreeUri转换为File路径，因为SAF设计的初衷就是让开发者直接通过Uri操作文件，而非依赖本地文件系统路径；
• 不要用文件名来判断根目录，不同存储的根目录名可能重复（比如部分设备的SD卡根目录也叫storage），用docId的结构判断才是最准确的方式。

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