Xamarin Android：Android 10下从含msf:documentid的Content URI获取真实路径

我之前也踩过这个坑！Android 10（API 29）开始推行的Scoped Storage是核心原因——它彻底限制了APP直接访问外部存储的真实文件路径，像你遇到的content://com.android.providers.downloads.documents/document/msf%3A180这种来自下载管理器的URI，本身就没有对应的真实路径可以解析，旧方法自然失效。

下面给你一套Xamarin Android下的替代解决方案，完全适配Scoped Storage规则：

为什么旧方法行不通？ #

Scoped Storage的核心逻辑是：APP不再拥有对外部存储的全局访问权限，只能通过系统授予的Content URI来临时操作文件。你看到的msf:前缀URI是MediaStore Files的缩写，这类URI是系统封装的虚拟标识，没有对应的物理文件路径。

正确处理方式：直接用Content URI操作文件 #

既然拿不到真实路径，我们换个思路——直接通过Content URI读取或复制文件内容，而非执着于获取路径。

1. 从Intent中获取Content URI #

在文件选择后的回调中拿到用户选择的URI：

protected override void OnActivityResult(int requestCode, Result resultCode, Intent data)
{
    base.OnActivityResult(requestCode, resultCode, data);
    if (resultCode == Result.Ok && data?.Data != null)
    {
        var contentUri = data.Data;
        // 用这个URI处理文件
        HandleSelectedFile(contentUri);
    }
}

2. 读取Content URI对应的文件流 #

直接读取流来使用，比如复制到APP私有目录：

private void HandleSelectedFile(Android.Net.Uri contentUri)
{
    // 获取文件名（可选）
    var fileName = GetFileNameFromUri(contentUri);
    // 复制到APP私有目录，这里的路径是可直接访问的
    var privateFile = new File(FilesDir, fileName);

    using (var inputStream = ContentResolver.OpenInputStream(contentUri))
    using (var outputStream = new FileStream(privateFile.AbsolutePath, FileMode.Create))
    {
        inputStream.CopyTo(outputStream);
    }

    // 现在可以用privateFile.AbsolutePath来操作文件了
}

// 辅助方法：从Content URI获取文件名
private string GetFileNameFromUri(Android.Net.Uri contentUri)
{
    string fileName = null;
    var cursor = ContentResolver.Query(contentUri, null, null, null, null);
    if (cursor != null && cursor.MoveToFirst())
    {
        var nameColumnIndex = cursor.GetColumnIndex(Android.Provider.OpenableColumns.DisplayName);
        fileName = cursor.GetString(nameColumnIndex);
        cursor.Close();
    }
    // 兜底生成临时文件名
    return fileName ?? $"temp_{Guid.NewGuid()}.tmp";
}

3. 针对需要真实路径的第三方库 #

如果某些第三方库只接受文件路径，可以把文件复制到APP的外部私有目录（这里的路径是合法可访问的）：

private string GetUsableFilePath(Android.Net.Uri contentUri)
{
    var fileName = GetFileNameFromUri(contentUri);
    var externalPrivateDir = GetExternalFilesDir(Android.OS.Environment.DirectoryDocuments);
    var destFile = new File(externalPrivateDir, fileName);

    using (var inputStream = ContentResolver.OpenInputStream(contentUri))
    using (var outputStream = new FileStream(destFile.AbsolutePath, FileMode.Create))
    {
        inputStream.CopyTo(outputStream);
    }

    return destFile.AbsolutePath;
}

关键注意事项 #

• 不要尝试用反射或其他手段绕过Scoped Storage，这些方法在Android 11+会彻底失效，还可能违反Google Play政策。
• 如果你的APP目标版本暂时是API 29，可以在AndroidManifest.xml中添加android:requestLegacyExternalStorage="true"临时兼容旧代码，但这只是过渡方案，Android 12+会强制禁用该选项。

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