使用Xamarin Forms从内部存储加载图片不显示问题咨询

你遇到的这个情况我之前也碰到过，大概率是权限缺失或者平台特定路径处理不当导致的，尤其是在Android 10及以上版本，系统的存储机制有不少变化，咱们一步步来排查解决：

一、先排查存储权限问题 #

Android对外部存储的访问权限管控很严格，哪怕文件确实存在，没有权限也读不出来：

1. 先给Android项目的AndroidManifest.xml加上必要权限：

<!-- Android 9及以下需要的读取权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- 如果涉及写入操作，还要加这个 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

<!-- Android 10+ 暂时绕过Scoped Storage（适合临时调试，长期建议适配新机制） -->
<application android:requestLegacyExternalStorage="true" ...>

2. 动态申请权限（Android 6+要求危险权限必须动态申请）：
   给你的MainPage加个权限请求方法，点击按钮前先确认权限：

private async Task RequestStoragePermission()
{
    var permissionStatus = await Permissions.CheckStatusAsync<Permissions.StorageRead>();
    if (permissionStatus != PermissionStatus.Granted)
    {
        permissionStatus = await Permissions.RequestAsync<Permissions.StorageRead>();
    }
}

private async void Button_Clicked(object sender, EventArgs e)
{
    // 先请求权限
    await RequestStoragePermission();
    
    bool exists = file.Exists(); 
    if(exists)
    {
        ImageExample.Source = ImageSource.FromFile(file.Path);
    }
}

二、改用跨平台的路径处理方式 #

你直接用了Android原生的GetExternalStoragePublicDirectory，在Xamarin Forms这种跨平台框架里，更推荐用跨平台API来获取路径，避免平台依赖：

// 用Xamarin.Essentials获取公共图片目录（跨平台适配）
var picturesDirectory = FileSystem.GetExternalStoragePublicDirectory(StorageDirectory.Pictures);
var filePath = Path.Combine(picturesDirectory, "tmp.jpg");
var targetFile = new FileInfo(filePath);

三、适配Android 10+的Scoped Storage机制 #

从Android 10开始，默认启用Scoped Storage，直接访问公共存储目录会受限。如果不想适配复杂的MediaStore，也可以把图片放到应用的私有外部存储目录（这个目录不需要额外权限）：

// 获取应用私有外部存储的图片目录
var privatePicsDir = Android.App.Application.Context.GetExternalFilesDir(Android.OS.Environment.DirectoryPictures);
var filePath = Path.Combine(privatePicsDir.AbsolutePath, "tmp.jpg");

四、尝试异步加载图片 #

有时候同步加载可能会有隐藏问题，试试异步加载的方式：

private async void Button_Clicked(object sender, EventArgs e)
{
    await RequestStoragePermission();
    
    bool exists = file.Exists(); 
    if(exists)
    {
        ImageExample.Source = await ImageSource.FromFileAsync(file.Path);
    }
}

按这个顺序排查，先解决权限问题，再调整路径和加载方式，应该就能让图片正常显示了。

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