在 .NET MAUI 中实现文件上传，核心思路是：先用
FilePicker选中本地文件，读取为字节数组或流，再通过
HttpClient以 multipart/form-data 方式发送到服务器。MAUI 本身不内置“上传控件”，需手动组合 API 完成。
1. 请求文件访问权限（Android/iOS 平台必需）
尤其在 Android 10+ 和 iOS 上，读取相册、文档等需显式申请权限：
Android：在AndroidManifest.xml添加
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"></uses-permission>（图片）、
READ_MEDIA_FILES（通用）或
READ_EXTERNAL_STORAGE（旧版） iOS：在
Info.plist添加
NSPhotoLibraryUsageDescription等描述字段 运行时调用
Permissions.RequestAsync<permissions.storageread>()</permissions.storageread>获取授权（推荐使用
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<Device, IEnumerable<string>> { ... })
});
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<IActionResult> 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 类型是否对齐。
