.NET6 Web API中List<T>返回XML、IEnumerable<T>返回JSON的原因？

核心现象 #

从.NET Framework 4.7迁移到.NET6 Web应用时，出现以下序列化行为差异：

• 返回IEnumerable<T>的接口默认输出JSON
• 返回List<T>的接口默认输出XML，即使调用.AsEnumerable()转换编译类型后仍输出XML
• 在Program.cs中调整OutputFormatters顺序，将JSON格式化器前置后，List<T>可正常返回JSON

底层原因 #

这是.NET6 Web API序列化器的类型匹配规则差异导致的：

1. XML序列化器的优先级：XmlSerializerOutputFormatter默认优先匹配有明确实现的具体类型（比如List<T>），因为XmlSerializer需要具体类型的元数据才能生成XML结构。
2. JSON序列化器的 fallback 逻辑：对于IEnumerable<T>这类抽象接口，XmlSerializer无法直接序列化（缺少具体实现的元数据），会自动 fallback 到SystemTextJsonOutputFormatter，因此返回JSON。
3. .AsEnumerable()的本质：这个方法仅改变List<T>的编译时类型为IEnumerable<T>，但运行时类型依然是List，XML序列化器仍能识别到具体类型并优先处理，所以还是返回XML。
4. 与.NET Framework 4.7的差异：旧版本Web API默认使用Newtonsoft.Json作为JSON序列化器，它对所有集合类型的匹配优先级高于XML序列化器，因此不会出现这类差异。

解决方案 #

方案1：全局设置JSON序列化优先 #

在Program.cs的控制器配置中调整OutputFormatters顺序，让JSON格式化器优先处理所有类型：

builder.Services.AddControllers(options =>
{
    // 将JSON格式化器插入到最前面，优先使用
    options.OutputFormatters.Insert(0, new SystemTextJsonOutputFormatter(
        new System.Text.Json.JsonSerializerOptions(System.Text.Json.JsonSerializerDefaults.Web)));
    // 后置XML格式化器
    options.OutputFormatters.Insert(1, new XmlSerializerOutputFormatter());
});

方案2：单个接口强制指定返回格式 #

在目标接口上添加[Produces]特性，强制该接口返回JSON：

[AllowAnonymous]
[HttpGet]
[ActionName("listall")]
[Produces("application/json")] // 强制输出JSON
public IActionResult ListAll()
{
    using (var websiteClientService = new WebsiteClientService())
    {
        List<WebsiteClientListItem> websiteClientResults = websiteClientService.ListAll().ToList();
        websiteClientResults.Insert(0, new WebsiteClientListItem() { Name = "Default Website", Id = -1 });
        return Ok(websiteClientResults);
    }
}

方案3：转换为非具体集合类型 #

将List<T>转换为数组（T[]），数组属于.NET内置通用集合类型，JSON序列化器会优先处理：

return Ok(websiteClientResults.ToArray());

总结 #

• .NET6中XML序列化器对具体集合类型的匹配优先级高于JSON序列化器，是导致差异的核心原因
• 编译时类型转换不改变运行时类型，无法绕过XML序列化器的匹配逻辑
• 可通过全局调整格式化器顺序、局部特性指定或类型转换三种方式解决问题

内容的提问来源于stack exchange，提问作者Adam Hey