.NET MAUI 文件上传需三步：1. 申请存储读取权限（Android/iOS）；2. 用 FilePicker.PickAsync 选文件并读为字节数组；3. 用 HttpClient 构造 MultipartFormDataContent 发送，注意流一次性及前后端字段名、MIME 对齐。

在 .NET MAUI 中实现文件上传，核心思路是：先用 FilePicker 选中本地文件，读取为字节数组或流，再通过 HttpClient 以 multipart/form-data 方式发送到服务器。MAUI 本身不内置“上传控件”，需手动组合 API 完成。

1. 请求文件访问权限（Android/iOS 平台必需）

尤其在 Android 10+ 和 iOS 上，读取相册、文档等需显式申请权限：

• Android：在 AndroidManifest.xml 添加 （图片）、READ_MEDIA_FILES（通用）或 READ_EXTERNAL_STORAGE（旧版）
• iOS：在 Info.plist 添加 NSPhotoLibraryUsageDescription 等描述字段
• 运行时调用 Permissions.RequestAsync() 获取授权（推荐使用 Microsoft.Maui.Essentials.Permissions）

2. 选择文件并读取为流

使用 FilePicker.PickAsync() 获取用户选中的文件，它返回 FileResult，包含可打开的 OpenReadAsync() 流：

var result = await FilePicker.PickAsync(new PickOptions
{
    PickerTitle = "选择要上传的文件",
    FileTypes = FilePickerFileType.Images // 或自定义 MimeType，如 new FilePickerFileType(new Dictionary> { ... })
});

if (result != null)
{
    using var stream = await result.OpenReadAsync();
    // 后续用 stream 构建上传内容
}

3. 使用 HttpClient 发送 multipart 表单上传

服务器通常接收标准 HTML 表单格式（multipart/form-data），需构造 MultipartFormDataContent：

var client = new HttpClient();
var content = new MultipartFormDataContent();

// 添加文件流（name 字段需与后端约定，如 "file"）
var fileStream = await result.OpenReadAsync();
var fileBytes = await StreamToByteArrayAsync(fileStream); // 辅助方法：读取全部字节
var fileContent = new ByteArrayContent(fileBytes);
fileContent.Headers.ContentType = MediaTypeHeaderValue.Parse(result.ContentType ?? "application/octet-stream");
content.Add(fileContent, "file", result.FileName);

// 可选：添加其他字段，如 token、id
content.Add(new StringContent("123", Encoding.UTF8), "userId");

var response = await client.PostAsync("https://your-api.com/upload", content);
if (response.IsSuccessStatusCode)
{
    var resultJson = await response.Content.ReadAsStringAsync();
}

注意：不要直接传 stream 到 StreamContent 并重复使用——MAUI 的 FileResult.OpenReadAsync() 返回的流是一次性流，且可能已关闭；稳妥做法是先读成 byte[] 或 MemoryStream。

4. 服务端接收建议（以 ASP.NET Core 为例）

后端需能解析 multipart 请求，例如：

[HttpPost("upload")]
public async Task Upload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("文件为空");

    var uploadsFolder = Path.Combine(Directory.GetCurrentDirectory(), "uploads");
    Directory.CreateDirectory(uploadsFolder);
    var filePath = Path.Combine(uploadsFolder, file.FileName);

    await using var stream = new FileStream(filePath, FileMode.Create);
    await file.CopyToAsync(stream);

    return Ok(new { message = "上传成功", fileName = file.FileName });
}

确保控制器参数名（file）与前端 content.Add(..., "file", ...) 中的 name 一致。

基本上就这些。MAUI 文件上传不复杂但容易忽略权限和流生命周期问题，重点盯住 FileResult.OpenReadAsync() 的一次性行为，以及前后端字段名、MIME 类型是否对齐。