Android文档树与SD卡开发问题：仅能操作根目录无法访问子文件夹

看起来你已经踩中了Android存储访问框架（SAF）的几个常见坑，别慌，咱们一步步捋清楚问题所在：

1. 先确认权限是否正确持久化 #

你提到已经从onActivityResult获取了Tree URI，但要记住：默认的权限是临时的，重启App后就会失效，而且必须明确申请读写权限并持久化。在onActivityResult里要这么处理：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == YOUR_REQUEST_CODE && resultCode == RESULT_OK) {
        Uri treeUri = data.getData();
        // 申请持久化读写权限
        getContentResolver().takePersistableUriPermission(
            treeUri,
            Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION
        );
        // 保存Tree URI（比如存在SharedPreferences里）
        saveTreeUri(treeUri);
    }
}

如果只申请了读权限，那子目录的写入操作肯定会失败，这点要先排查。

2. 必须用DocumentFile操作子目录，别碰File类 #

Android 10及以上，SD卡的子目录不能再用传统的File类直接访问了，必须通过DocumentFile来操作——这是很多开发者踩坑的地方。举个例子：

• 获取根目录的DocumentFile：

Uri treeUri = getSavedTreeUri(); // 从存储中取出之前保存的Tree URI
DocumentFile rootDir = DocumentFile.fromTreeUri(this, treeUri);

• 遍历子文件夹：

for (DocumentFile file : rootDir.listFiles()) {
    if (file.isDirectory()) {
        // 这就是子文件夹的DocumentFile，直接用它操作就行
        Log.d("TAG", "子文件夹：" + file.getName());
    }
}

• 在子文件夹内创建新目录：

// 先找到目标子文件夹
DocumentFile targetSubDir = null;
for (DocumentFile file : rootDir.listFiles()) {
    if (file.isDirectory() && "我的子文件夹".equals(file.getName())) {
        targetSubDir = file;
        break;
    }
}
if (targetSubDir != null) {
    // 在子文件夹内创建新目录
    DocumentFile newDir = targetSubDir.createDirectory("新文件夹");
    if (newDir != null) {
        Log.d("TAG", "新目录创建成功");
    } else {
        Log.e("TAG", "新目录创建失败，检查权限或SD卡状态");
    }
}

关键在于：所有子目录的操作都必须基于父目录的DocumentFile对象，而不是自己拼接路径去创建新的Uri——那样会因为权限问题被系统拒绝。

3. 排查SD卡的特殊限制 #

有些品牌的设备（比如部分三星、小米机型）对SD卡有额外的权限限制，比如需要在系统设置里手动开启"允许修改SD卡"的权限，或者SD卡本身处于只读状态。你可以先在系统文件管理器里试试能不能在SD卡子目录创建文件夹，如果系统都做不到，那App肯定也不行。

4. 验证Tree URI的权限范围 #

你可以通过getContentResolver().getPersistedUriPermissions()来查看已持久化的权限列表，确认对应的Tree URI是否包含读写权限，以及权限是否覆盖了整个SD卡目录（而不是某个特定子目录）。

按照这几个步骤排查，应该就能解决只能操作SD卡根目录的问题了。

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