ASP.NET Core MVC如何配置仅404、500错误重定向到首页

核心问题说明 #

你自定义的中间件没有触发重定向的核心原因是：代码使用的是服务端路径重写逻辑，而非客户端重定向逻辑，同时缺少必要的参数配置、状态码重置操作，且可能存在中间件顺序错误的问题。

解决方案 #

以下提供三种可选实现方案，可根据你的业务需求选择：

方案1：客户端重定向（地址栏跳转至首页，和原有UseStatusCodePagesWithRedirects效果一致，仅拦截404、500） #

直接修改中间件为调用重定向方法即可，代码如下：

app.Use(async (ctx, next) =>
{
    await next();
    if ((ctx.Response.StatusCode == 404 || ctx.Response.StatusCode == 500) && !ctx.Response.HasStarted)
    {
        // 清空已写入的响应内容
        ctx.Response.Clear();
        // 触发302临时重定向，如需永久重定向可使用RedirectPermanent方法
        ctx.Response.Redirect($"/?error={ctx.Response.StatusCode}");
        // 直接返回响应，不需要继续执行后续管道
        return;
    }
});

方案2：使用原生内置方法实现，无需自定义中间件 #

ASP.NET Core原生的UseStatusCodePages支持自定义过滤逻辑，写法更简洁稳定：

app.UseStatusCodePages(context =>
{
    var code = context.HttpContext.Response.StatusCode;
    // 仅对404、500错误执行重定向
    if (code is 404 or 500)
    {
        context.HttpContext.Response.Redirect($"/?error={code}");
    }
    // 其余错误码（如400）不做处理，走原有逻辑
    return Task.CompletedTask;
});

方案3：服务端路径重写（地址栏保持原错误URL，返回首页内容） #

如果你不需要地址栏跳转，只需要返回首页内容，修改原有代码如下即可：

app.Use(async (ctx, next) =>
{
    await next();
    if ((ctx.Response.StatusCode == 404 || ctx.Response.StatusCode == 500) && !ctx.Response.HasStarted)
    {
        // 重置响应状态码为200，避免浏览器识别为错误页面
        ctx.Response.StatusCode = 200;
        // 拆分设置路径和查询参数，不要拼接在Path中
        ctx.Request.Path = "/";
        ctx.Request.QueryString = new QueryString($"?error={ctx.Response.StatusCode}");
        // 重新执行管道处理新的路径
        await next();
    }
});

注意事项 #

• 该中间件必须放在管道最靠前的位置，需要早于UseStaticFiles、UseRouting、UseEndpoints等中间件注册，才能正确捕获所有中间件返回的错误码
• 若你同时配置了异常处理中间件UseExceptionHandler，需要确保该中间件放在UseExceptionHandler之后，避免异常被提前捕获导致500状态码无法被拦截

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