.NET 6（Azure Functions v4）全局异常触发自定义操作方案咨询

在Azure Functions v4（.NET 6）环境下，你可以通过以下方式实现全局异常捕获并执行自定义操作（比如发送HTTP请求记录错误）：

方案一：使用IFunctionExceptionFilter（官方推荐） #

这是Azure Functions官方支持的全局异常处理方案，能捕获所有函数执行过程中抛出的未处理异常（包括空引用异常等）。

步骤1：实现自定义异常过滤器 #

创建实现IFunctionExceptionFilter接口的类，在其中嵌入你的错误发送逻辑：

using Microsoft.Azure.Functions.Worker;
using Microsoft.Azure.Functions.Worker.Filters;
using System.Net.Http;
using System.Text;

public class GlobalExceptionFilter : IFunctionExceptionFilter
{
    private readonly IHttpClientFactory _httpClientFactory;

    // 通过依赖注入获取HttpClient工厂
    public GlobalExceptionFilter(IHttpClientFactory httpClientFactory)
    {
        _httpClientFactory = httpClientFactory;
    }

    public async Task OnExceptionAsync(FunctionExceptionContext exceptionContext)
    {
        var exception = exceptionContext.Exception;
        // 执行自定义错误发送操作
        await SendErrorMessage(exception);

        // 可选：重新抛出异常，让Functions运行时继续处理（比如写入Application Insights）
        // throw exception;
    }

    private async Task<Exception> SendErrorMessage(Exception ex)
    {
        var client = _httpClientFactory.CreateClient("ErrorLogger");
        // 可序列化完整异常信息（含堆栈跟踪），替代仅发送Message
        var errorContent = new StringContent(
            ex.ToString(),
            Encoding.UTF8,
            "application/json"
        );
        await client.PostAsync("", errorContent);
        return ex;
    }
}

步骤2：注册过滤器和HttpClient #

在Program.cs中配置服务，完成异常过滤器和HttpClient的注册：

using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        // 注册全局异常过滤器
        services.AddScoped<IFunctionExceptionFilter, GlobalExceptionFilter>();
        
        // 配置HttpClient，自定义基础地址、超时等参数
        services.AddHttpClient("ErrorLogger", client =>
        {
            client.BaseAddress = new Uri("https://myloggingurl.com/");
            client.Timeout = TimeSpan.FromSeconds(10);
        });
    })
    .Build();

host.Run();

关键注意事项 #

• 必须使用await：务必等待PostAsync执行完成，否则异步操作可能在函数进程终止前未完成，导致错误请求发送失败。
• 扩展异常信息：若需要更详细的错误日志，可将ex.ToString()（包含堆栈跟踪）或序列化整个异常对象作为请求内容，而非仅发送ex.Message。
• HTTP触发器自定义响应：针对HTTP触发器，可通过exceptionContext.GetHttpResponse()修改返回给客户端的响应，例如返回500状态码和自定义提示：

  var response = exceptionContext.GetHttpResponse();
  response.StatusCode = System.Net.HttpStatusCode.InternalServerError;
  response.WriteString("服务器内部错误");
  

• 异常重新抛出：如果需要让Functions运行时继续处理异常（比如写入默认日志系统），可在OnExceptionAsync方法中重新抛出异常。

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