Android使用SAF获SD卡权限时默认打开空白最近文件夹的解决问询

嘿，我完全懂你遇到的这个痛点——用户找不到SD卡入口确实容易懵，私有API兼容性太差肯定不是长久之计，这里给你两个实用的解决方案：

方案一：指定SAF初始打开目录（Android 10+支持） #

从Android 10（API 29）开始，ACTION_OPEN_DOCUMENT_TREE支持通过DocumentsContract.EXTRA_INITIAL_URI参数直接指定初始打开的目录。你可以尝试获取SD卡的根目录Uri，把它传给Intent，这样就能直接定位到SD卡目录了。

修改后的代码如下：

private void getSDCardAccess(){
    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
    
    // 获取SD卡根目录的Uri（适配标准外部存储）
    Uri sdCardRootUri = DocumentsContract.buildRootUri("com.android.externalstorage.documents", "primary");
    
    // 仅在Android 10及以上版本设置初始目录
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, sdCardRootUri);
    }
    
    startActivityForResult(intent, REQUEST_EXTERNAL_ACCESS);
}

⚠️ 注意：部分设备的SD卡挂载标识可能不是primary，如果这个方法失效，你可以通过StorageManager获取所有可移动存储卷，精准定位SD卡：

@RequiresApi(api = Build.VERSION_CODES.N)
private Uri getSDCardRootUri() {
    StorageManager storageManager = (StorageManager) getActivity().getSystemService(Context.STORAGE_SERVICE);
    List<StorageVolume> volumes = storageManager.getStorageVolumes();
    
    for (StorageVolume volume : volumes) {
        // 筛选可移动的存储设备（SD卡）
        if (volume.isRemovable()) {
            return volume.createOpenDocumentTreeIntent().getParcelableExtra(DocumentsContract.EXTRA_INITIAL_URI);
        }
    }
    
    // 兜底返回默认外部存储
    return DocumentsContract.buildRootUri("com.android.externalstorage.documents", "primary");
}

方案二：添加用户引导对话框（全版本兼容） #

如果指定初始目录的方法在某些旧设备上不生效，最稳妥的方式是在启动SAF前弹出一个引导提示，清晰告诉用户怎么找到SD卡入口。

代码示例：

private void getSDCardAccess(){
    new AlertDialog.Builder(getActivity())
            .setTitle("请选择SD卡目录")
            .setMessage("点击右上角的菜单图标，选择您的SD卡存储，然后选择根目录即可获取写入权限")
            .setPositiveButton("知道了", (dialog, which) -> {
                // 启动SAF选择器
                Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
                startActivityForResult(intent, REQUEST_EXTERNAL_ACCESS);
            })
            .setCancelable(false)
            .show();
}

这个方法虽然需要用户手动操作，但胜在100%兼容所有设备，通过明确的提示能有效降低用户的困惑。

总结 #

建议你优先尝试方案一，同时把方案二作为兜底——大部分Android 10+的用户可以直接进入SD卡目录，旧设备用户也能通过提示找到正确路径，兼顾体验和兼容性。

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