Android平台下如何为MAUI Image控件添加自定义HTTP请求头

方法1：自定义UriImageSource处理程序 #

MAUI支持替换UriImageSource的默认加载逻辑，通过自定义IImageSourceHandler可以在图片请求中添加认证令牌，完全接管HTTP请求流程。

1. 创建自定义处理类：

using Microsoft.Maui.Handlers;
using Microsoft.Maui.Platform;
using System.Net.Http.Headers;

public class AuthenticatedUriImageHandler : IImageSourceHandler
{
    private readonly HttpClient _httpClient;
    private readonly ISettingsService _settingsService;

    public AuthenticatedUriImageHandler(ISettingsService settingsService)
    {
        _settingsService = settingsService;
        _httpClient = new HttpClient(new HttpClientHandler());
    }

    public async Task<IImageSourceServiceResult<IImage>> LoadImageAsync(ImageSource imageSource, ImageSourceServiceOptions options, CancellationToken cancellationToken = default)
    {
        if (imageSource is not UriImageSource uriSource)
            return ImageSourceServiceResult<IImage>.Failed(new InvalidOperationException("仅支持UriImageSource类型"));

        var token = _settingsService.GetDeviceToken();
        _httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);

        using var response = await _httpClient.GetAsync(uriSource.Uri, cancellationToken);
        response.EnsureSuccessStatusCode();

        using var stream = await response.Content.ReadAsStreamAsync(cancellationToken);
        var platformImage = await PlatformImage.FromStreamAsync(stream, cancellationToken);

        return ImageSourceServiceResult<IImage>.Success(platformImage);
    }
}

2. 在MauiProgram.cs中注册自定义处理程序：

builder.Services.AddSingleton<AuthenticatedUriImageHandler>();

builder.ConfigureMauiHandlers(handlers =>
{
    var handler = builder.Services.BuildServiceProvider().GetRequiredService<AuthenticatedUriImageHandler>();
    handlers.AddHandler<UriImageSource>(() => handler);
});

方法2：使用StreamImageSource手动控制请求 #

直接通过StreamImageSource手动实现带认证的图片请求，同时可以自定义缓存策略。

示例代码：

private readonly ISettingsService _settingsService;

// 构造函数注入ISettingsService
public YourViewModel(ISettingsService settingsService)
{
    _settingsService = settingsService;
}

public StreamImageSource GetAuthenticatedImage(string imageUrl)
{
    return new StreamImageSource
    {
        Stream = async (cancellationToken) =>
        {
            var token = _settingsService.GetDeviceToken();
            using var httpClient = new HttpClient();
            httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
            
            var response = await httpClient.GetAsync(imageUrl, cancellationToken);
            response.EnsureSuccessStatusCode();
            
            return await response.Content.ReadAsStreamAsync(cancellationToken);
        },
        CacheValidity = TimeSpan.FromDays(7) // 设置缓存有效期
    };
}

在XAML或代码中为Image控件赋值：

yourImageControl.Source = GetAuthenticatedImage("https://your-api-domain.com/image/123");

补充：本地缓存优化 #

如果需要更可靠的缓存，可以结合MAUI的IFileSystem服务实现本地文件缓存，避免重复请求：

private readonly IFileSystem _fileSystem;
private readonly string _cacheDirectory;

public YourImageService(IFileSystem fileSystem)
{
    _fileSystem = fileSystem;
    _cacheDirectory = Path.Combine(_fileSystem.CacheDirectory, "AuthImages");
    Directory.CreateDirectory(_cacheDirectory);
}

public async Task<Stream> GetCachedImageStream(string imageUrl, CancellationToken token)
{
    // 用URL的哈希值作为缓存文件名
    var cacheKey = Convert.ToHexString(SHA256.HashData(Encoding.UTF8.GetBytes(imageUrl))).ToLower();
    var cachePath = Path.Combine(_cacheDirectory, $"{cacheKey}.jpg");

    // 优先读取本地缓存
    if (File.Exists(cachePath))
    {
        return File.OpenRead(cachePath);
    }

    // 带认证请求远程图片
    var tokenValue = _settingsService.GetDeviceToken();
    using var httpClient = new HttpClient();
    httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", tokenValue);
    
    var response = await httpClient.GetAsync(imageUrl, token);
    response.EnsureSuccessStatusCode();
    
    // 写入本地缓存
    using var stream = await response.Content.ReadAsStreamAsync(token);
    using var fileStream = File.Create(cachePath);
    await stream.CopyToAsync(fileStream, token);
    
    return File.OpenRead(cachePath);
}

然后在StreamImageSource中调用该方法即可。

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