.NET 8 Isolated Azure Functions调用列表不显示未处理异常详情

将Azure Functions从进程内迁移到.NET 8隔离模式后，未捕获的NotImplementedException仅能在Application Insights的outerMessage字段看到详情，但Invocation列表仅显示空白错误，核心原因是隔离模式下宿主与函数进程分离的架构，导致默认异常处理策略不对外暴露原始异常信息。

解决方法 #

1. 添加全局异常处理中间件 #

隔离模式基于ASP.NET Core管道，可通过自定义中间件捕获全局异常，将详情返回至Invocation列表：

先创建异常处理中间件类：

public class ExceptionHandlingMiddleware : IFunctionsWorkerMiddleware
{
    private readonly ILogger<ExceptionHandlingMiddleware> _logger;

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

    public async Task Invoke(FunctionContext context, FunctionExecutionDelegate next)
    {
        try
        {
            await next(context);
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "Function execution failed");
            // 针对HTTP触发的函数，返回异常详情
            var httpContext = await context.GetHttpContextAsync();
            if (httpContext != null)
            {
                httpContext.Response.StatusCode = StatusCodes.Status500InternalServerError;
                httpContext.Response.ContentType = "application/json";
                await httpContext.Response.WriteAsJsonAsync(new
                {
                    ErrorMessage = ex.Message,
                    StackTrace = ex.StackTrace
                });
            }
            // 非HTTP触发场景，需对应修改输出绑定逻辑传递异常信息
        }
    }
}

接着在Program.cs中注册中间件：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults(builder =>
    {
        builder.UseMiddleware<ExceptionHandlingMiddleware>();
    })
    .Build();

host.Run();

2. 调整host.json日志配置（可选） #

若需让Invocation列表关联更详细的日志记录，可修改host.json的日志配置：

{
  "logging": {
    "applicationInsights": {
      "samplingSettings": {
        "isEnabled": true,
        "excludedTypes": "Request"
      },
      "enableLiveMetricsFilters": true
    },
    "logLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "Function": "Error"
    }
  }
}

注意事项 #

• 生产环境建议仅返回友好错误信息，完整异常详情保留在Application Insights中，避免泄露敏感信息。
• 非HTTP触发的函数（如Timer、Queue），需适配修改输出绑定逻辑，确保异常信息能在Invocation列表中显示。

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