如何让ASP.NET Core的void/Task动作方法返回204 No Content

我之前也踩过这个坑——ASP.NET Core里void或者Task类型的Action默认会返回200 OK，哪怕你加了[ProducesResponseType(204)]也没用，因为这个属性只用来生成API文档（比如Swagger），不会实际修改运行时的响应状态码。下面给你几个实用的解决方案：

方案一：自定义全局Action过滤器（推荐） #

通过过滤器拦截Action的执行结果，把默认的EmptyResult（void/Task类型Action的默认返回结果）替换成NoContentResult。

步骤1：实现过滤器类 #

public class NoContentResultFilter : IAsyncActionFilter
{
    public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
    {
        // 先执行Action逻辑
        var executionResult = await next();
        
        // 检查是否是默认的EmptyResult，是的话替换为204响应
        if (executionResult.Result is EmptyResult)
        {
            executionResult.Result = new NoContentResult();
        }
    }
}

步骤2：注册过滤器 #

在Program.cs里把过滤器添加到全局Mvc配置中，这样所有void/Task类型的Action都会自动返回204：

builder.Services.AddControllers(options =>
{
    options.Filters.Add<NoContentResultFilter>();
});

如果只想给特定的Controller或Action应用这个规则，也可以用[TypeFilter]属性标注：

[TypeFilter(typeof(NoContentResultFilter))]
public class MyController : Controller
{
    // ...你的Action方法
}

方案二：手动包装返回结果（适合局部场景） #

如果只是个别Action需要修改，也可以把Task类型改成Task<IActionResult>，然后手动返回NoContent()，就像你示例里的Bar方法那样。不过这种方式需要逐个修改Action，适合不想全局修改的场景。

为什么[ProducesResponseType(204)]不生效？ #

再强调一下：这个属性的作用是告诉API文档生成工具（比如Swagger）该Action可能返回的状态码，它不会影响运行时的响应处理逻辑。所以要实际改变状态码，必须通过过滤器或者手动返回特定结果的方式。

用方案一改造后，你示例里的Foo方法就会和Bar方法一样，返回204 No Content了。

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