ASP.NET Core Razor页面中间件异常未捕获，生产环境如何处理？

核心原因：中间件注册顺序错误 #

.NET Core的中间件管道按注册顺序执行，UseExceptionHandler作为异常捕获中间件，必须放在所有可能抛出异常的中间件（包括你的自定义身份验证中间件）之前，否则无法捕获后续中间件抛出的异常。

具体修复步骤 #

1. 调整中间件注册顺序 #

修改Program.cs（或Startup.cs）中的中间件注册代码，确保UseExceptionHandler和UseHsts在自定义身份验证中间件之前：

if (!app.Environment.IsDevelopment())
{
    // 异常处理中间件必须先注册
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

// 然后注册你的自定义身份验证中间件
app.UseMiddleware<YourCustomAuthMiddleware>();

// 其他中间件（路由、静态文件等）
app.UseRouting();
app.UseAuthorization();
// ...

2. 确保自定义中间件正确抛出异常 #

检查自定义中间件实现，确保异常在异步流程中正确抛出，没有被吞掉。示例实现如下：

public async Task InvokeAsync(HttpContext context, SignInManager<ApplicationUser> signInManager, ILogger<YourCustomAuthMiddleware> logger)
{
    // 用户查询逻辑
    var user = // 获取用户的代码;

    if (user != null)
    {
        await signInManager.SignInAsync(user, true);
        context.User = await signInManager.CreateUserPrincipalAsync(user);
        logger.LogInformation($"User with id {user.Id}, name {user.UserName} successfully signed in");
    }
    else
    {
        logger.LogInformation("User cannot be found in identity store.");
        // 直接抛出异常，确保被上游异常处理中间件捕获
        throw new InvalidOperationException("user not found.");
    }

    // 继续执行管道后续中间件
    await _next(context);
}

3. 确保错误页面返回正确状态码 #

默认/Error页面可能返回200状态码，导致客户端无法识别为500错误。可在Error.cshtml.cs中设置响应状态码：

public class ErrorModel : PageModel
{
    private readonly ILogger<ErrorModel> _logger;

    public ErrorModel(ILogger<ErrorModel> logger)
    {
        _logger = logger;
    }

    public string? RequestId { get; set; }

    public bool ShowRequestId => !string.IsNullOrEmpty(RequestId);

    public void OnGet()
    {
        RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier;
        // 设置响应状态码为500
        HttpContext.Response.StatusCode = StatusCodes.Status500InternalServerError;
    }
}

4. 排查其他吞异常的中间件 #

检查管道中其他中间件是否存在try-catch包裹await next()的情况，若有需确保捕获异常后重新抛出：

app.Use(async (context, next) =>
{
    try
    {
        await next();
    }
    catch (Exception ex)
    {
        // 日志记录后重新抛出，让异常处理中间件捕获
        _logger.LogError(ex, "An error occurred");
        throw;
    }
});

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