Android 12中Intent ACTION_OPEN_DOCUMENT的EXTRA_INITIAL_URI失效求助

核心问题 #

你的代码存在三个关键错误，导致EXTRA_INITIAL_URI参数无法生效：

1. Uri类型不匹配
   EXTRA_INITIAL_URI要求传入DocumentsProvider规范的Uri，但你通过FileProvider或Uri.fromFile()生成的是文件系统Uri，系统文件选择器无法识别这类Uri作为初始目录。

2. 重复设置Action导致参数失效
   你同时调用了intent.setAction(Intent.ACTION_OPEN_DOCUMENT)和intent.setAction(Intent.ACTION_GET_CONTENT)，后者会覆盖前者。而ACTION_GET_CONTENT并不支持EXTRA_INITIAL_URI参数，这是参数失效的直接原因。

3. 传入文件Uri而非目录Uri
   你传入的是单个PDF文件的Uri，但EXTRA_INITIAL_URI需要的是目标目录的Uri，不是具体文件的Uri。

修复步骤 #

步骤1：先获取目标目录的DocumentsProvider Uri #

由于Android存储权限限制，无法直接生成指定目录的DocumentsProvider Uri，必须先让用户通过ACTION_OPEN_DOCUMENT_TREE授权访问目标目录，再保存这个Uri用于后续复用：

// 注册目录选择的ActivityResultLauncher
ActivityResultLauncher<Intent> getDirLauncher = registerForActivityResult(
    new ActivityResultContracts.StartActivityForResult(),
    result -> {
        if (result.getResultCode() == Activity.RESULT_OK && result.getData() != null) {
            Uri treeUri = result.getData().getData();
            // 持久化目录Uri到SharedPreferences
            getContext().getSharedPreferences("app_prefs", Context.MODE_PRIVATE)
                .edit()
                .putString("initial_dir_uri", treeUri.toString())
                .apply();
            
            // 申请持久化访问权限，避免重启后失效
            getContext().getContentResolver().takePersistableUriPermission(
                treeUri,
                Intent.FLAG_GRANT_READ_URI_PERMISSION
            );
        }
    }
);

// 触发目录选择流程
private void requestDirAccess() {
    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
    getDirLauncher.launch(intent);
}

步骤2：修正文件选择Intent #

使用保存的目录Uri，并且只保留ACTION_OPEN_DOCUMENT动作：

private void openFile() {
    SharedPreferences prefs = getContext().getSharedPreferences("app_prefs", Context.MODE_PRIVATE);
    String dirUriStr = prefs.getString("initial_dir_uri", null);
    
    // 如果未保存目录Uri，先引导用户选择
    if (dirUriStr == null) {
        requestDirAccess();
        return;
    }
    
    Uri initialDirUri = Uri.parse(dirUriStr);
    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
    intent.setType("application/pdf");
    intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, initialDirUri);
    // 限定只显示可打开的文件
    intent.addCategory(Intent.CATEGORY_OPENABLE);
    
    GetDoc2.launch(intent);
}

步骤3：关键注意事项 #

• 首次运行必须让用户手动选择一次目标目录，之后才能复用该目录作为初始位置；
• 必须调用takePersistableUriPermission保证App重启后仍能访问该目录；
• 避免硬编码路径（如/sdcard/eduphone），可通过Environment.getExternalStorageDirectory() + "/eduphone"获取通用路径，但核心仍需用户授权对应目录。

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