ActivityResultContracts.OpenDocumentTree启动位置异常问题求助

核心问题分析 #

1. 起始Uri格式错误：你使用Uri.fromFile()生成的是file://协议的Uri，而OpenDocumentTree要求传入的是SAF（Storage Access Framework）兼容的content://协议Uri。从Android 10（API 29）开始，应用专属目录的file://Uri对系统文件选择器不可见，会被直接忽略，导致文件选择器默认打开上次访问的目录。
2. 按钮不显示原因：当文件选择器打开应用专属目录时，系统判定该目录为应用私有空间，因此隐藏"Use This Folder"按钮；只有导航到公共目录（如Documents、Downloads）时，按钮才会显示。

解决方案 #

1. 正确获取公共Documents目录的content:// Uri #

通过MediaStore查询公共Documents目录的content Uri，再转换为SAF可识别的树形Uri：

private Uri getPublicDocumentsTreeUri() {
    ContentResolver resolver = requireContext().getContentResolver();
    // 针对API 29+的外部存储主卷
    Uri baseUri = MediaStore.Files.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY);
    String relativePath = Environment.DIRECTORY_DOCUMENTS + "/";
    String selection = MediaStore.Files.FileColumns.RELATIVE_PATH + " = ?";
    String[] selectionArgs = new String[]{relativePath};

    Cursor cursor = resolver.query(baseUri, new String[]{MediaStore.Files.FileColumns._ID}, selection, selectionArgs, null);
    if (cursor != null && cursor.moveToFirst()) {
        long documentId = cursor.getLong(0);
        cursor.close();
        // 构建SAF兼容的树形Uri
        return DocumentsContract.buildDocumentUriUsingTree(baseUri, String.valueOf(documentId));
    }
    //  fallback：如果查询失败，使用默认的外部存储Documents目录Uri
    return Uri.parse("content://com.android.externalstorage.documents/tree/primary%3ADocuments");
}

2. 修正启动文件选择器的代码 #

将原来的Uri.fromFile(...)替换为上述方法获取的Uri：

binding.exportInventorySearchButton.setOnClickListener(view1 -> {
    binding.exportInventorySelectedFolderText.setText("");
    binding.exportInventoryStartButton.setEnabled(false);
    // 使用公共Documents目录的SAF Uri启动选择器
    Uri startUri = getPublicDocumentsTreeUri();
    selectInventoryExportFolder.launch(startUri);
});

3. 修复代码中的空指针问题 #

你的代码中设置文本时错误使用了未赋值的selectedExportFolder，需替换为docFolder：

binding.exportInventorySelectedFolderText.setText(
        String.format("%s %s",
                getString(R.string.text_selected_folder),
                docFolder.getName())); // 原代码为selectedExportFolder.getName()，会触发空指针
selectedExportFolder = docFolder;

额外说明 #

• 对于API <29的设备，上述方法同样适用，系统会自动适配公共目录的Uri。
• 如果希望默认打开其他公共目录（如Downloads），只需将Environment.DIRECTORY_DOCUMENTS替换为Environment.DIRECTORY_DOWNLOADS即可。

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