.NET 6+ Web API 默认不支持 XML 响应，因移除了 XmlSerializerOutputFormatter，需手动安装 Microsoft.AspNetCore.Mvc.Formatters.Xml 包并注册该格式化器，且模型须满足无参构造、public 属性等要求。
为什么默认不支持 XML 响应
.NET 6+ 的 Web API 模板默认只注册 SystemTextJsonOutputFormatter，完全移除了对 XML 的自动支持。即使你返回 IActionResult 或启用了 [Produces("application/xml")]，请求带 Accept: application/xml 也会直接 406 Not Acceptable。
添加 XmlSerializerOutputFormatter 的正确方式
必须显式注册基于 XmlSerializer 的格式化器（XmlDataContractSerializer 已被弃用且不推荐用于 Web API）。注意：.NET 5+ 不再内置 XML 支持包，需先安装 NuGet 包：
dotnet add package Microsoft.AspNetCore.Mvc.Formatters.Xml
然后在 Program.cs 中注册：
builder.Services.AddControllers(options =>
{
options.OutputFormatters.Add(new XmlSerializerOutputFormatter());
// 可选：禁用默认的 JSON 格式化器（仅需 XML 时）
// options.OutputFormatters.RemoveType<JsonResultExecutor>();
});
关键点：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
-
XmlSerializerOutputFormatter要求模型类有无参构造函数，且属性必须是 public get/set - 不支持
record类型（会抛InvalidOperationException: Type 'X' cannot be serialized） - 若控制器方法返回
Task<IActionResult>，确保实际返回值类型可被XmlSerializer序列化（如Ok(MyModel)）
处理 XML 请求（POST/PUT）
仅配置输出格式化器不够——接收 XML 请求体还需注册输入格式化器：
builder.Services.AddControllers(options =>
{
options.InputFormatters.Add(new XmlSerializerInputFormatter(options));
options.OutputFormatters.Add(new XmlSerializerOutputFormatter());
});
此时需确保请求头包含 Content-Type: application/xml，且 XML 结构与模型字段名严格匹配（区分大小写，无命名空间更稳妥）。常见失败原因：
- XML 根节点名 ≠ 模型类名（
XmlRoot特性可覆盖） - 字段名含下划线或驼峰，但 XML 使用短横线（如
<user-name>）→ 需加[XmlElement("user-name")] - 传了空字符串给非 nullable 引用类型字段 → 反序列化失败
调试 406 或空响应的快速检查项
当 XML 响应不生效时，优先验证以下三点：
- 是否漏装
Microsoft.AspNetCore.Mvc.Formatters.Xml包？没有它，XmlSerializerOutputFormatter类型根本不存在 - 是否在
AddControllers()后才调用Build()？顺序错误会导致注册失效 - 是否误用了
services.AddMvc()（已过时）？.NET 6+ 推荐统一用AddControllers()+AddEndpointsApiExplorer() - 是否在
Startup.Configure()中忘了调用app.UseRouting()和app.UseEndpoints()？中间件链中断会导致格式化器不触发
XML 格式化器本身不处理缩进或编码声明，生成的 XML 默认无换行、UTF-8 无 BOM。如果需要美化输出，得自己封装 XmlWriterSettings 并继承 XmlSerializerOutputFormatter —— 这部分容易被低估工作量。
