Android应用无法访问可移除SD卡，PDF搜索仅生效于内部存储

DevOps 小满

2026-5-8

问题分析与解决方案

首先，核心问题出在你用来启动搜索的路径上：Environment.getExternalStorageDirectory()这个方法只指向内部存储的公共外部目录（也就是/storage/emulated/0/），并不包含可移除的SD卡。之前能搜到SD卡文件可能是因为旧版本Android的行为差异，恢复出厂后系统版本更新或者SD卡挂载逻辑变化，导致这个方法不再覆盖可移除SD卡路径。

为什么之前有效现在失效？

从Android 4.4开始，系统对可移除SD卡的访问权限做了严格限制，Environment.getExternalStorageDirectory()的语义被明确为"内部存储的外部分区"，而非所有外部存储设备。到了Android 10（API 29）及以上，这个方法甚至被标记为过时，官方推荐使用存储卷API或存储访问框架（SAF）来访问外部存储。

实现同时搜索内部存储与可移除SD卡的方法

要覆盖所有存储设备，你需要通过StorageManager获取系统中所有可用的存储卷，包括内部存储和可移除SD卡，然后对每个存储卷的根目录分别执行搜索逻辑。

步骤1：修改存储路径获取逻辑

先实现一个方法，获取所有可访问的存储根目录：

private List<File> getAllAccessibleStorageDirs(Context context) {
    List<File> storageDirs = new ArrayList<>();
    StorageManager storageManager = (StorageManager) context.getSystemService(Context.STORAGE_SERVICE);
    List<StorageVolume> storageVolumes = storageManager.getStorageVolumes();

    for (StorageVolume volume : storageVolumes) {
        // 过滤掉未挂载或不可读的存储卷
        if (!volume.isMounted() || !volume.isReadable()) {
            continue;
        }

        File volumeRootDir;
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            // Android 10+ 直接通过getDirectory()获取根目录
            volumeRootDir = volume.getDirectory();
        } else {
            // 低版本需要反射获取路径（因为getPath()是隐藏API）
            try {
                Method getPathMethod = StorageVolume.class.getMethod("getPath");
                String volumePath = (String) getPathMethod.invoke(volume);
                volumeRootDir = new File(volumePath);
            } catch (Exception e) {
                e.printStackTrace();
                continue;
            }
        }

        if (volumeRootDir.exists() && volumeRootDir.isDirectory()) {
            storageDirs.add(volumeRootDir);
        }
    }
    return storageDirs;
}

步骤2：优化搜索方法的存储逻辑

你当前的Search_Dir方法每次找到匹配文件会覆盖path变量，最后只能得到最后一个匹配的路径。建议改成用List存储所有结果：

// 全局变量存储所有找到的PDF路径
private List<String> foundPdfPaths = new ArrayList<>();

private void Search_Dir(File dir) {
    try {
        String pdfPattern = displayName; 
        File[] fileList = dir.listFiles();
        if (fileList != null) {
            for (File file : fileList) {
                if (file.isDirectory()) {
                    Search_Dir(file);
                } else {
                    // 用equals更准确，避免匹配到文件名末尾包含目标名称的其他文件
                    if (file.getName().equals(pdfPattern)) {
                        foundPdfPaths.add(file.getAbsolutePath());
                    }
                }
            }
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
}

步骤3：启动多存储卷搜索

替换原来的单路径调用，遍历所有存储卷启动搜索：

// 清空之前的搜索结果
foundPdfPaths.clear();
// 获取所有可访问的存储目录
List<File> storageDirs = getAllAccessibleStorageDirs(this);
// 逐个搜索每个存储卷
for (File dir : storageDirs) {
    Search_Dir(dir);
}
// 现在foundPdfPaths里就是所有匹配的PDF路径了

权限注意事项

如果你的应用目标SDK是Android 10（API 29）及以上，还需要注意：

READ_EXTERNAL_STORAGE权限的限制：这个权限只能访问媒体文件（图片、音频、视频），PDF属于文档类文件，无法直接通过文件路径访问。
解决方案选择：
- 若需要后台自动搜索所有存储，需申请MANAGE_EXTERNAL_STORAGE权限（在Manifest中添加<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />），然后引导用户到应用设置开启"允许管理所有文件"的权限。但这个权限的Google Play审核严格，仅适合文件管理器类应用。
- 更合规的方式是使用存储访问框架（SAF）：让用户通过系统文件选择器选择需要搜索的目录（包括SD卡），然后通过DocumentFile遍历搜索。这种方式不需要特殊权限，但需要用户手动授权。

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