Android Xamarin C# 实现HTTP图片下载、ImageView显示及权限配置求助

你当前代码抛出WebException的核心常见诱因 #

你碰到的System.Net.WebException: 'An exception occurred during a WebClient request.'，绝大多数情况是以下3种原因触发，没有复杂的隐藏问题：

• 未在项目清单中配置基础网络权限，系统直接拦截所有出网请求
• 把同步下载逻辑直接写在UI主线程，触发安卓网络访问主线程限制
• 写入文件的路径没有系统分配的访问权限，IO错误被WebClient统一包装成WebException抛出

安卓端相关权限配置说明 #

完全不需要申请敏感的外部存储权限，只要按以下配置走就能覆盖全部需求：

• 必加核心权限：在Properties/AndroidManifest.xml中添加android.permission.INTERNET，只要应用需要联网就必须配置，缺失的话所有网络请求都会直接失败
• 安卓9（API 28）以上适配：如果需要访问老旧的非加密HTTP站点，在manifest的<application>节点添加android:usesCleartextTraffic="true"即可，访问HTTPS站点不需要额外配置
• 关键认知：应用专属存储目录是系统为单个应用隔离分配的空间，其他应用无法访问，应用卸载时目录会自动清除，往该目录写文件完全不需要申请WRITE_EXTERNAL_STORAGE、MANAGE_EXTERNAL_STORAGE这类动态申请的危险权限，能省掉大量适配流程

完整可运行代码实现 #

1. 创建应用专属图片存储目录、自动保留原文件名 #

直接使用系统提供的应用内部存储根路径，不需要额外权限，同时从下载URL中自动提取文件原始名称，避免硬编码文件名：

// 获取应用专属内部存储根路径
var appRootPath = Application.Context.FilesDir.Path;
// 创建专门的图片存储子目录
var imageSaveDir = Path.Combine(appRootPath, "DownloadedImages");
if (!Directory.Exists(imageSaveDir))
{
    Directory.CreateDirectory(imageSaveDir);
}

// 从下载URL自动提取原始文件名
string downloadUrl = "https://i.sstatic.net/X3V3w.png";
Uri downloadUri = new Uri(downloadUrl);
string originalFileName = Path.GetFileName(downloadUri.LocalPath);
// 拼接最终保存的文件全路径
string fullSavePath = Path.Combine(imageSaveDir, originalFileName);

2. 异步下载逻辑（避免主线程阻塞） #

不要用同步的下载方法，把下载任务放到后台线程，下载完成后再切回UI线程更新界面，从根源上避免主线程网络异常：

await Task.Run(async () =>
{
    using (var webClient = new WebClient())
    {
        // 可选：配置常规UA标识，避免被部分站点拦截返回403错误
        webClient.Headers.Add("User-Agent", "Mozilla/5.0 (Android) XamarinApp");
        await webClient.DownloadFileTaskAsync(downloadUri, fullSavePath);

        // 下载完成后切回UI线程执行图片加载
        MainThread.BeginInvokeOnMainThread(() =>
        {
            LoadLocalImageToImageView(fullSavePath);
        });
    }
});

3. 本地图片加载到ImageView #

从本地路径读取图片时加采样压缩逻辑，避免加载大图直接触发内存溢出：

private ImageView imageView; // 绑定你页面上的ImageView控件实例
private void LoadLocalImageToImageView(string localImagePath)
{
    if (!File.Exists(localImagePath)) return;

    // 先读取图片原始尺寸，不直接加载全图
    var decodeOptions = new BitmapFactory.Options
    {
        InJustDecodeBounds = true
    };
    BitmapFactory.DecodeFile(localImagePath, decodeOptions);

    // 按ImageView实际尺寸计算采样率，降低内存占用
    decodeOptions.InSampleSize = CalculateSampleRate(decodeOptions, imageView.Width, imageView.Height);
    decodeOptions.InJustDecodeBounds = false;

    // 按采样率加载压缩后的Bitmap
    var compressedBitmap = BitmapFactory.DecodeFile(localImagePath, decodeOptions);
    imageView.SetImageBitmap(compressedBitmap);
}

// 辅助方法：计算图片采样率
private int CalculateSampleRate(BitmapFactory.Options options, int targetWidth, int targetHeight)
{
    int originalHeight = options.OutHeight;
    int originalWidth = options.OutWidth;
    int sampleRate = 1;
    if (originalHeight > targetHeight || originalWidth > targetWidth)
    {
        int halfHeight = originalHeight / 2;
        int halfWidth = originalWidth / 2;
        while ((halfHeight / sampleRate) >= targetHeight && (halfWidth / sampleRate) >= targetWidth)
        {
            sampleRate *= 2;
        }
    }
    return sampleRate;
}

高频踩坑点提醒 #

• 不要把保存路径换成公共外部存储目录（比如Android.OS.Environment.ExternalStorageDirectory.Path），在安卓10以上的分区存储规则下，这种路径就算申请了存储权限也会触发写入失败，直接用应用专属的FilesDir路径就能完全绕开分区存储的适配问题
• 如果碰到HTTPS证书校验失败的Web异常，可在应用启动时添加临时证书校验回调（生产环境请谨慎使用，避免安全风险）

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