.NET Core中IExceptionHandler全局异常处理重定向后URL未变更问题

全局异常处理类中调用httpContext.Response.Redirect("/Home/Error")后，浏览器URL仍停留在出错页面，未切换到/Home/Error，同时开发者异常页面也未正常触发。

问题原因 #

1. ExceptionHandler中间件机制限制：ASP.NET Core的ExceptionHandler中间件默认采用服务器端内部重写（类似Server.Transfer），不会触发浏览器端的URL跳转，手动调用Response.Redirect会因为中间件已经接管响应流程而失效。
2. 配置冲突：同时配置了app.UseExceptionHandler("/Home/Error")和自定义IExceptionHandler实现，两者逻辑冲突，导致重定向逻辑未按预期执行。
3. 中间件顺序错误：UseExceptionHandler相关配置的位置不符合ASP.NET Core中间件执行顺序要求，导致异常捕获逻辑未生效。
4. 响应状态码冲突：在重定向前手动设置了HttpStatusCode.BadRequest，覆盖了重定向所需的3xx状态码，导致浏览器无法识别跳转指令。

解决方案 #

步骤1：修正DI与中间件配置

移除冲突的UseExceptionHandler("/Home/Error")，确保自定义异常处理器的中间件正确注册，并且调整中间件顺序（UseExceptionHandler必须在UseRouting、UseAuthorization之前）。

修改后的中间件配置：

app.UseSession();

// 配置自定义异常处理器，放在最前面（除了日志、会话等基础中间件）
app.UseExceptionHandler();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.MapRazorPages();

app.Run();

同时，DI配置中移除重复的注册（保留AddExceptionHandler<GlobalExceptionHandler>即可）：

builder.Services.AddRazorPages();
builder.Services.AddHttpContextAccessor();
// 移除重复的 AddSingleton<IExceptionHandler, GlobalExceptionHandler>
builder.Services.AddExceptionHandler<GlobalExceptionHandler>();
var connectionString = builder.Configuration.GetConnectionString("connection");
builder.Services.AddScoped(provider => new DataService(connectionString));
builder.Services.AddRazorPages().AddRazorRuntimeCompilation();

builder.Services.AddDistributedMemoryCache();
builder.Services.AddSession(options =>
{
    options.IdleTimeout = TimeSpan.FromMinutes(20);
    options.Cookie.HttpOnly = true;
    options.Cookie.IsEssential = true;
});

步骤2：修改全局异常处理类逻辑

根据需求选择两种方案：

方案A：客户端跳转（URL改变）

移除错误的状态码设置，直接触发客户端重定向：

public async ValueTask<bool> TryHandleAsync(HttpContext httpContext, Exception exception, CancellationToken cancellationToken)
{
    if (exception != null)
    {
        var response = new ExceptionResponse()
        {
            ErrorDatetime = DateTime.Now.ToString(),
            ExceptionMessage = exception.Message,
            Title = "Something went wrong",
            ErrorPath = httpContext.Request.Path,
            Method = httpContext.Request.Method,
            UserLogin = httpContext.Session?.GetString("userid"),
            ErrorStackTrace = exception.StackTrace
        };

        LogException(response);

        // 清除之前的响应设置，触发客户端重定向
        httpContext.Response.Clear();
        httpContext.Response.Redirect("/Home/Error");

        return true;
    }

    return false;
}

方案B：服务器端内部转发（URL不变）

如果不需要改变URL，只想显示错误页面，可让ExceptionHandler中间件内部转发：

public async ValueTask<bool> TryHandleAsync(HttpContext httpContext, Exception exception, CancellationToken cancellationToken)
{
    if (exception != null)
    {
        var response = new ExceptionResponse()
        {
            ErrorDatetime = DateTime.Now.ToString(),
            ExceptionMessage = exception.Message,
            Title = "Something went wrong",
            ErrorPath = httpContext.Request.Path,
            Method = httpContext.Request.Method,
            UserLogin = httpContext.Session?.GetString("userid"),
            ErrorStackTrace = exception.StackTrace
        };

        LogException(response);

        // 设置异常处理特性，让中间件转发到Error页面
        httpContext.Features.Set<IExceptionHandlerFeature>(new ExceptionHandlerFeature
        {
            Error = exception,
            Path = "/Home/Error"
        });

        // 设置正确的状态码
        httpContext.Response.StatusCode = (int)HttpStatusCode.InternalServerError;

        return true;
    }

    return false;
}

步骤3：确保Error视图正确存在

确认Home/Error.cshtml视图存在于Views/Home目录下，并且可以正常渲染。

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