.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 类型是否对齐。
