如何让ASP.NET Core Web API返回真实404（如同控制器不存在）

你遇到的核心问题是：ASP.NET Core Web API的控制器默认会将404等错误状态码包装成ProblemDetails格式的JSON响应，而你需要的是像路由不存在时那样，返回无JSON内容的404，让浏览器显示默认的404页面。

原因分析 #

默认情况下，ASP.NET Core的ApiBehaviorOptions会自动将控制器返回的错误状态码（如404）转换为标准化的ProblemDetails JSON响应，这是框架的默认行为，并非ASP.NET Core 6的新特性。

解决方案 #

方案1：直接返回空结果并设置状态码（单Action处理） #

在目标Action中，手动设置响应状态码并返回EmptyResult，绕过框架的ProblemDetails包装逻辑：

[HttpGet]
public IActionResult Index()
{
    if (!_isEnabled)
    {
        // 手动设置404状态码
        Response.StatusCode = StatusCodes.Status404NotFound;
        // 返回空结果，避免框架生成JSON响应
        return new EmptyResult();
    }

    // 正常业务逻辑
    return Ok("Action is enabled");
}

这种方式会让响应仅包含404状态码和空内容，浏览器会显示其默认的404页面，和访问不存在的路由效果一致。

方案2：全局修改ApiBehaviorOptions（批量处理） #

如果需要全局统一控制错误响应格式，可以在Program.cs中配置ApiBehaviorOptions，禁用或自定义ProblemDetails的生成逻辑：

builder.Services.Configure<ApiBehaviorOptions>(options =>
{
    // 移除404的默认错误映射
    options.ClientErrorMapping.Remove(StatusCodes.Status404NotFound);
});

不过这种方式仍可能返回极简的JSON结构，不如方案1直接返回空结果更贴近“路由不存在”的体验。

方案3：使用中间件提前拦截（批量隐藏Action） #

如果有多个Action需要根据条件隐藏，可以通过自定义中间件在路由匹配后、进入控制器前直接返回404：

1. 定义一个标记属性，用于标记需要条件启用的Action：

[AttributeUsage(AttributeTargets.Method)]
public class ConditionalEnableAttribute : Attribute
{
    // 可根据实际需求从配置读取，这里简化为直接设置
    public bool IsEnabled { get; set; }
}

2. 编写中间件：

public class ConditionalEnableMiddleware
{
    private readonly RequestDelegate _next;

    public ConditionalEnableMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        var endpoint = context.GetEndpoint();
        if (endpoint != null)
        {
            var enableAttr = endpoint.Metadata.GetMetadata<ConditionalEnableAttribute>();
            if (enableAttr != null && !enableAttr.IsEnabled)
            {
                context.Response.StatusCode = StatusCodes.Status404NotFound;
                return;
            }
        }

        await _next(context);
    }
}

3. 在Program.cs中注册中间件（需放在MapControllers之前）：

// 注册自定义中间件
app.UseMiddleware<ConditionalEnableMiddleware>();

app.MapControllers();

4. 在目标Action上标记属性：

[HttpGet]
[ConditionalEnable(IsEnabled = false)]
public IActionResult Index()
{
    // 正常业务逻辑
    return Ok("Action is enabled");
}

这种方式会直接在中间件层拦截请求，不会进入Action执行，完全模拟路由不存在的行为。

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