在.NET 7及更高版本中，Minimal APIs以极简方式构建HTTP端点，但当客户端需要上传XML文件时，并不能像JSON那样依靠框架自动完成模型绑定。开发者必须显式处理请求中的多媒体表单数据，并从字节流中还原XML对象。下面直接说明具体做法与原理。
通过IFormFile接收XML上传
Minimal APIs中定义上传端点最直观的方式是使用IFormFile参数。框架会将multipart/form-data请求里的文件部分映射为该类型实例。我们需要从OpenReadStream读取内容，再用XmlSerializer反序列化。注意端点必须明确支持表单内容，否则请求会被拒绝。
以下示例展示一个接收XML并转换为强类型对象的端点。其中模型类需用[XmlRoot]等特性描述结构，序列化器才能正确映射节点。
using Microsoft.AspNetCore.Mvc;
using System.Xml.Serialization;
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
public class UserProfile
{
[XmlElement("name")]
public string Name { get; set; }
[XmlElement("age")]
public int Age { get; set; }
}
app.MapPost("/upload-xml", async (IFormFile file) =>
{
if (file == null || file.Length == 0)
return Results.BadRequest("未接收到文件");
using var stream = file.OpenReadStream();
var serializer = new XmlSerializer(typeof(UserProfile));
try
{
var profile = (UserProfile)serializer.Deserialize(stream);
return Results.Ok(new { profile.Name, profile.Age });
}
catch (InvalidOperationException ex)
{
return Results.BadRequest("XML解析失败: " + ex.Message);
}
});
app.Run();
这段代码没有使用[Consumes]特性，因为IFormFile本身已暗示消费multipart表单。如果错误地加上Consumes("application/xml")，而客户端以form-data发送，就会返回415状态码。这是实践中常见的误区。
该方案的优点是简单直观，适合单文件上传。缺点是每次都要手动写反序列化逻辑，且无法利用框架的自动验证。若需复用，可封装为扩展方法。
直接读取原始请求体处理XML
另一种场景是客户端不以表单形式、而是将XML作为请求正文直接发送，内容类型设为application/xml或text/xml。此时端点应接收HttpRequest，读取Body流并解析。这种方式更贴近传统XML Web服务。
下面代码演示如何禁用缓冲、读取流并用序列化器转换。注意要指定正确的编码，避免中文乱码。
app.MapPost("/xml-body", async (HttpRequest request) =>
{
if (!request.ContentType.Contains("xml"))
return Results.BadRequest("内容类型不支持");
using var reader = new StreamReader(request.Body, System.Text.Encoding.UTF8);
string xmlText = await reader.ReadToEndAsync();
var serializer = new XmlSerializer(typeof(UserProfile));
using var stringReader = new StringReader(xmlText);
try
{
var profile = (UserProfile)serializer.Deserialize(stringReader);
return Results.Ok(profile);
}
catch (Exception ex)
{
return Results.BadRequest(ex.Message);
}
});
直接读取正文的方式省去了表单封装，适合机器对机器通信。但它要求调用方严格遵循XML格式与内容类型，否则容易触发解析异常。在Minimal APIs中，这种端点可通过app.MapPost配合Consumes("application/xml")明确契约。
对比两种方案：表单上传对浏览器和调试工具更友好；原始正文更轻量且语义清晰。团队应根据客户端能力选择，而不应混用导致接口歧义。
配置与注意事项
在.NET 7+项目中，默认已包含必要的反序列化依赖，但需确认Program.cs未移除表单绑定服务。若使用IFormFile，框架依赖MultipartReader，通常无需额外配置。对于大文件，可设置request.FormOptions限制大小。
另外，XML中存在特殊字符时，要确保客户端做了转义。服务端用XmlSerializer比XDocument更利于映射模型，但灵活性稍弱。若结构多变，可改用XDocument.Parse手动取值。
app.MapPost("/xml-linq", async (HttpRequest req) =>
{
using var sr = new StreamReader(req.Body);
string text = await sr.ReadToEndAsync();
var doc = System.Xml.Linq.XDocument.Parse(text);
var name = doc.Root.Element("name")?.Value;
return Results.Ok(name);
});
上述代码利用LINQ to XML避开强类型约束，适合临时接口。生产环境建议保留模型校验，并结合FluentValidation等库增强健壮性。只要理清请求格式与绑定机制，Minimal APIs处理XML上传并不复杂。
Minimal_APIsXML_upload.NET_7修改时间：2026-08-02 03:42:24