.NET Core 3.1全局异常捕获技术咨询：UseExceptionHandler中间件异常触发延迟及非控制器类无try-catch捕获方案

咱们一步步来拆解你遇到的这几个问题：

一、为什么部分异常需要点击“继续”才会进入异常控制器？ #

你看到的这个现象，大概率是调试器的拦截行为，而非app.UseExceptionHandler()中间件的问题：

• 在Visual Studio的调试模式下，默认会启用「CLR异常捕获」（你可以通过Debug > Windows > Exception Settings查看这个设置）。当任何.NET异常抛出时，调试器会先暂停程序，等你点击“继续”后，异常才会继续流转到异常处理中间件。
• 到了生产环境，这个调试器拦截不会存在，异常会直接被你的异常控制器捕获。
• 另外一种小概率情况：如果异常是在请求管道之外的代码中抛出（比如应用启动时的配置逻辑、后台线程/定时任务、未被await的异步操作），这类异常不会自动进入请求管道的异常处理流程，需要额外的全局处理逻辑。

二、不用try-catch捕获辅助类/非Controller类的异常 #

核心思路是让异常能自然冒泡到请求管道，或者通过全局事件捕获管道外的异常：

1. 请求管道内的代码（比如Action调用辅助类） #

如果辅助类的方法是在Controller的Action、Filter或其他请求管道中间件内被调用的，只要你没有在辅助类内部吞掉异常（也就是没写try-catch却不重新抛出），异常会自动向上冒泡，最终被app.UseExceptionHandler()捕获。举个简单例子：

// 你的辅助类
public class UriHelper
{
    public Uri CreateEmptyUri()
    {
        return new Uri(""); // 这里抛出的异常会直接冒泡到调用方
    }
}

// Controller里调用辅助类
public IActionResult TestUri()
{
    var helper = new UriHelper();
    helper.CreateEmptyUri(); // 异常从这里继续向上到请求管道
    return Ok();
}

2. 请求管道外的代码（后台任务、异步未await等） #

对于这类脱离请求上下文的场景，需要在应用启动时订阅全局异常事件，在Program.cs或Startup.cs里添加：

// 处理所有未被捕获的托管异常
AppDomain.CurrentDomain.UnhandledException += (sender, args) =>
{
    var exception = args.ExceptionObject as Exception;
    // 这里可以用ILogger记录异常，或者做自定义告警
    Console.WriteLine($"全局未处理异常：{exception?.StackTrace}");
};

// 处理未被await的Task异常
TaskScheduler.UnobservedTaskException += (sender, args) =>
{
    Console.WriteLine($"未观察到的Task异常：{args.Exception.StackTrace}");
    args.SetObserved(); // 标记异常已处理，避免进程意外终止（可选）
};

三、.NET Core 3.1中捕获所有错误并定位辅助类的异常位置 #

要实现全量异常捕获并精确定位到辅助类的代码行，需要结合以下几个步骤：

1. 正确配置异常处理中间件 #

确保app.UseExceptionHandler()在管道的最前面（除了日志中间件），这样能捕获后续所有中间件的异常：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        // 生产环境指向自定义异常页面/控制器
        app.UseExceptionHandler("/Error");
        app.UseHsts();
    }

    // 其他中间件（路由、授权等）要放在异常处理中间件之后
    app.UseHttpsRedirection();
    app.UseStaticFiles();
    app.UseRouting();
    app.UseAuthorization();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    });
}

2. 记录完整的异常堆栈信息 #

在你的异常控制器里，一定要记录异常的StackTrace属性，它会包含异常发生的具体文件、类和行号。比如：

[Route("Error")]
public class ErrorController : Controller
{
    private readonly ILogger<ErrorController> _logger;

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

    public IActionResult Index()
    {
        var exceptionFeature = HttpContext.Features.Get<IExceptionHandlerPathFeature>();
        var exception = exceptionFeature.Error;
        
        // 记录完整异常信息，包括堆栈跟踪
        _logger.LogError(exception, "请求路径 {Path} 发生异常", exceptionFeature.Path);
        
        return View();
    }
}

3. 处理启动阶段的异常 #

如果异常发生在应用启动时（比如Startup构造函数、ConfigureServices里的代码），这时候异常处理中间件还没生效，需要在Program.cs里包裹启动逻辑：

public static void Main(string[] args)
{
    try
    {
        CreateHostBuilder(args).Build().Run();
    }
    catch (Exception ex)
    {
        // 记录启动失败的异常
        var loggerFactory = LoggerFactory.Create(builder => builder.AddConsole());
        var logger = loggerFactory.CreateLogger<Program>();
        logger.LogCritical(ex, "应用启动失败");
        throw;
    }
}

4. 调试时的定位技巧 #

在Visual Studio中，你可以通过以下设置快速定位到辅助类的异常行：

• 关闭工具 > 选项 > 调试 > 常规里的「仅我的代码」选项，这样能看到完整的异常堆栈（包括框架代码）。
• 在Debug > Windows > Exception Settings里勾选「Common Language Runtime Exceptions」，这样调试时异常抛出的瞬间就会暂停，直接跳转到辅助类的代码行。

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