ASP.NET Core（二十三）API 接口 NULL 返回 HTTP 204 状态码

小渣渣

需求：使用 ASP.NET Core 6 新建了一个 Web Api 项目对外提供服务，接口有可能返回为空对象或者空字符串，如果返回 NULL 的话，接口响应为：204 No Content，虽然 204 代表正常响应码（并没有任何毛病），但是，一些封装的 HTTP 框架只会认为 200 状态码代表正常。所以要将 204 状态码改成 200 状态码。

接口代码：

登录可见。

测试如下图：



接口返回 HTTP 204 No Content 状态码，原因是因为 ASP.NET Core 中默认添加了 4 种输出格式化的实现：

• Microsoft.AspNetCore.Mvc.Formatters.HttpNoContentOutputFormatter
• Microsoft.AspNetCore.Mvc.Formatters.StringOutputFormatter
• Microsoft.AspNetCore.Mvc.Formatters.StreamOutputFormatter
• Microsoft.AspNetCore.Mvc.Formatters.SystemTextJsonOutputFormatter
  

HttpNoContentOutputFormatter 源码如下：

登录可见。

注意：接口返回类型为 void、Task 会返回 HTTP 200 状态码，因为并不会进入到 HttpNoContentOutputFormatter 中 CanWriteResult 方法！！！其中 CanWriteResult 方法返回 true，则会走 WriteAsync 方法。

登录可见。

解决方案

在 OutputFormatters 集合中删除 HttpNoContentOutputFormatter 实现类，代码如下：

登录可见。

再次访问接口，测试如下：

返回类型为 string?，返回 200 状态码，没有任何输出
返回类型为 object?，返回 200 状态码，输出 null

（完）