ASP.NET Core Web API添加自定义OutputFormatter后如何保留默认格式化器

这个现象和你猜测的“覆盖默认JSON格式化器”无关，核心原因有两个：

• 自定义的CSVOutputFormatter没有重写CanWriteResult方法做返回类型校验，导致它会对所有接口的返回值都宣告自己可处理，当请求携带Accept: */*通配符时，内容协商逻辑会匹配到该格式化器。
• 如果你开启了RespectBrowserAcceptHeader配置，ASP.NET Core会严格按Accept头匹配格式化器，通配符会匹配所有声明的SupportedMediaTypes，如果你的格式化器注册顺序在默认JSON格式化器之前，就会优先被选中。

1. 给自定义格式化器添加返回类型校验 #

重写CanWriteResult方法，限定它仅处理你需要导出CSV的目标模型，避免对普通JSON接口生效：

public override bool CanWriteResult(OutputFormatterCanWriteContext context)
{
    // 仅当返回值为你指定的model类型或它的集合时，才启用该格式化器
    if (context.Object is model || context.Object is IEnumerable<model>)
    {
        return base.CanWriteResult(context);
    }
    return false;
}

2. 调整服务注册配置 #

保证默认JSON/XML格式化器的优先级高于自定义格式化器，通配符请求优先返回JSON：

services.AddControllers(options =>
{
    // Add方法会将自定义格式化器追加到格式化器集合末尾，默认JSON格式化器会排在前面优先匹配
    options.OutputFormatters.Add(new CSVOutputFormatter());
    
    // 可选配置：没有匹配的格式化器时返回406错误，不会强制 fallback 到第一个格式化器
    options.ReturnHttpNotAcceptable = true;
    // 若不需要适配浏览器自定义Accept头，可保持默认的false，所有请求默认返回JSON
    // options.RespectBrowserAcceptHeader = true;
});

3. 可选：接口粒度控制格式 #

如果某类接口专门用于导出CSV，可以直接在Action或Controller上添加[Produces("text/csv")]特性，限定该接口仅使用CSV格式化器，不会和其他格式产生冲突。

你当前的实现存在线程安全风险：CSVOutputFormatter默认是单例注册的，你将ViewModel定义为类的全局属性，并发请求时会出现属性值被覆盖的问题，建议把ViewModel改为WriteResponseBodyAsync方法内的局部变量。另外生成的临时CSV文件在发送完成后要主动删除，避免占用磁盘空间。

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