ASP.NET Core异步Use方法无法触发异常助手的问题及调试问询

public class Program
{
    public static void Main(string[] args)
    {
        var builder = WebApplication.CreateBuilder(args);
        var app = builder.Build();

        int mode = 1;//1, 2, 3, or 4

        if (mode == 1)
        {
            app.Use(async (HttpContext context, RequestDelegate next) =>
            {
                await Task.Delay(1);
                throw new InvalidOperationException();//Not caught by exception helper
            });
        }

        if (mode == 2)
        {
            app.Use((HttpContext context, RequestDelegate next) =>
            {
                throw new InvalidOperationException();//Caught by exception helper
            });
        }

        if (mode == 3)
        {
            app.Run((HttpContext context) =>
            {
                throw new InvalidOperationException();//Caught by exception helper
            });
        }

        if (mode == 4)
        {
            app.MapGet("/", () =>
            {
                throw new InvalidOperationException();//Caught by exception helper
            });
        }

        app.Run();
    }
}

当mode=1（使用异步Use中间件）时，抛出的InvalidOperationException仅会在浏览器显示错误页面，无法触发Visual Studio的异常助手；而mode=2（同步Use）、mode=3（Run）、mode=4（MapGet）时，异常助手可正常触发，允许冻结程序、查看局部变量等调试操作。

原因分析 #

核心差异在于同步与异步代码的异常传播机制：

• 同步中间件抛出的异常直接在请求处理的同步执行流中抛出，ASP.NET Core框架此时还未进入异常捕获逻辑，调试器会立即检测到未被捕获的异常，触发异常助手。
• 异步中间件抛出的异常会被自动包装在返回的Task对象中，ASP.NET Core的请求管道会通过await关键字捕获这个Task的异常，并将其转换为HTTP 500响应。由于框架已经“观察”并处理了该异常，Visual Studio默认设置下不会触发中断——默认仅在未被观察到的Task异常或同步未捕获异常时触发异常助手。

解决方案：精准触发异常助手 #

要让异步中间件的未处理异常触发调试中断，同时忽略已被代码捕获的异常，可按以下步骤操作：

1. 启用「仅我的代码」功能 #

打开Visual Studio的工具 > 选项 > 调试 > 常规，勾选「启用“仅我的代码”」。该功能会让调试器忽略框架代码中的异常处理逻辑，只关注你编写的代码。

2. 配置异常设置 #

打开调试 > Windows > 异常设置，找到目标异常类型（比如System.InvalidOperationException），勾选「抛出」选项。此时调试器会在你的代码抛出该异常时立即中断，无论后续是否被框架处理；但如果异常被你自己的try-catch块捕获，调试器会识别到这是用户处理的异常，不会触发中断。

更新1场景验证 #

对于以下包含try-catch的异步中间件代码：

app.Use(async (HttpContext context, RequestDelegate next) =>
{
    await Task.Delay(1);
    try
    {
        File.ReadAllText("Missing File.txt");
    }
    catch (FileNotFoundException)
    {
        //handle missing file
    }
});

启用「仅我的代码」并勾选FileNotFoundException的「抛出」选项后，调试器不会在File.ReadAllText处中断——因为异常被你自己的catch块处理了，调试器会跳过已处理的异常，只在未被捕获的异常时触发中断。

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