如何处理ASP.NET Core Web MVC应用启动（Program.cs）时的错误重定向？

启动阶段的错误分两类：应用构建失败（如Program.cs配置、服务注册出错）和中间件管道执行错误（启动后首个请求触发的中间件异常），两者处理逻辑不同，以下是针对性解决方案：

一、中间件管道执行错误的处理（解决无限循环与500问题） #

1. 正确使用UseExceptionHandler #

你遇到的500错误，大概率是Error控制器自身抛出异常或路径配置错误。按以下步骤调整：

• 先单独访问/Error路径，确认控制器/视图能正常加载，无报错；
• 将UseExceptionHandler放在所有业务中间件之前（如UseRouting、UseEndpoints），避免异常被后续中间件拦截；
• 若担心控制器出错，可直接返回静态错误页面，绕过控制器依赖：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();

var app = builder.Build();

// 异常处理放在最前面
app.UseExceptionHandler(errorApp =>
{
    errorApp.Run(async context =>
    {
        context.Response.StatusCode = 500;
        context.Response.ContentType = "text/html";
        // 读取wwwroot下的静态错误页面
        await context.Response.WriteAsync(File.ReadAllText("wwwroot/500.html"));
    });
});

// 其他中间件配置
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

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

app.Run();

2. 自定义中间件避免无限循环 #

若坚持用自定义中间件，需判断当前请求是否已指向错误页面，防止重复重定向：

public class CustomErrorMiddleware
{
    private readonly RequestDelegate _next;

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

    public async Task InvokeAsync(HttpContext context)
    {
        try
        {
            await _next(context);
        }
        catch (Exception ex)
        {
            // 若当前请求已是错误页面，直接返回，避免循环
            if (context.Request.Path.StartsWithSegments("/Error"))
            {
                context.Response.StatusCode = 500;
                await context.Response.WriteAsync("错误页面加载失败");
                return;
            }
            context.Response.Redirect("/Error");
        }
    }
}

// 注册时放在业务中间件之前
app.UseMiddleware<CustomErrorMiddleware>();

二、应用构建失败的处理（Program.cs初始化错误） #

如果是builder.Build()之前抛出异常（如服务注册失败、配置读取错误），此时应用管道未建立，无法用常规中间件处理，需用 fallback 极简Web服务兜底：

try
{
    var builder = WebApplication.CreateBuilder(args);
    // 此处若出错（如服务依赖缺失），会进入catch
    builder.Services.AddSingleton<ISomeService, BrokenService>();

    var app = builder.Build();
    // 正常中间件配置...
    app.Run();
}
catch (Exception ex)
{
    // 启动极简Web服务，返回错误或重定向到外部站点
    var fallbackHost = new WebHostBuilder()
        .UseKestrel()
        .UseStartup<FallbackStartup>()
        .Build();
    
    fallbackHost.Run();
}

// Fallback启动类，仅处理错误响应
public class FallbackStartup
{
    public void Configure(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
            // 重定向到外部错误页面
            context.Response.Redirect("https://your-error-site.com");
            // 或直接返回本地错误提示
            // context.Response.ContentType = "text/html";
            // await context.Response.WriteAsync("<h1>应用启动失败，请稍后重试</h1>");
        });
    }
}

常见问题排查 #

• ERR_TOO_MANY_REDIRECTS：检查错误页面路径是否被异常处理逻辑重复捕获，比如错误页面自身抛出异常，或重定向路径与异常处理路径一致；
• UseExceptionHandler返回500：先简化Error控制器Action，直接返回静态文本排除控制器自身问题：

public class ErrorController : Controller
{
    public IActionResult Index()
    {
        return Content("服务器内部错误", "text/plain");
    }
}

内容的提问来源于stack exchange，提问作者Chau Chun