Azure .NET 5 Isolated Functions中间件无法捕获异常问题排查

问题核心原因 #

你使用的是.NET隔离进程模型的Azure Functions，默认情况下运行时内置中间件会优先捕获用户函数抛出的异常，将异常存入FunctionContext.InvocationResult的Exception属性中，不会冒泡到上层自定义中间件的catch块，这是你无法捕获异常的根本原因。

解决方案 #

方案1：主动检查执行结果中的异常（兼容所有版本） #

修改ExceptionLoggingMiddleware.cs的Invoke方法，在执行完后续管道后主动检查是否有被运行时捕获的异常：

public async Task Invoke(FunctionContext context, FunctionExecutionDelegate next)
{
    try
    {
        await next(context);
        // 检查执行结果是否包含异常
        if (context.InvocationResult is { IsFailure: true, Exception: not null } invokeResult)
        {
            var ex = invokeResult.Exception;
            var logger = context.GetLogger(context.FunctionDefinition.Name);
            logger.LogError("Unexpected Error in {FunctionName}: {Message}", context.FunctionDefinition.Name, ex.Message);
            
            // 若为Http触发可在此处自定义错误返回，同时标记异常已处理
            // var req = await context.GetHttpRequestDataAsync();
            // var resp = req.CreateResponse(System.Net.HttpStatusCode.InternalServerError);
            // await resp.WriteAsJsonAsync(new { error = "系统内部错误" });
            // context.GetInvocationResult().Value = resp;
            // invokeResult.Exception = null;
        }
    }
    catch (Exception ex)
    {
        // 捕获中间件管道自身抛出的异常
        var logger = context.GetLogger(context.FunctionDefinition.Name);
        logger.LogError("Middleware pipeline error in {FunctionName}: {Message}", context.FunctionDefinition.Name, ex.Message);
    }
}

方案2：开启异常传播配置（适用于Azure Functions Worker 1.8.0+版本） #

如果你希望异常可以直接冒泡到中间件的catch块，可以在Program.cs中开启用户代码异常传播开关，你的原有中间件try-catch逻辑不需要修改：

public static void Main()
{
    var host = new HostBuilder()
        .ConfigureFunctionsWorkerDefaults(
            builder =>
            {
                builder.UseMiddleware<ExceptionLoggingMiddleware>();
                // 新增配置：开启用户代码异常传播
                builder.Services.Configure<FunctionsWorkerOptions>(opt => 
                {
                    opt.EnableUserCodeExceptionPropagation = true;
                });
            }
        )
        .Build();

    host.Run();
}

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