如何阻止Azure Function发生异常时返回堆栈跟踪？

针对In-Process模型（.NET Framework/.NET Core） #

1. 全局异常过滤（推荐批量处理）

创建自定义异常过滤器，统一拦截所有未处理异常并返回干净的500响应：

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;

public class HideStacktraceExceptionFilter : IExceptionFilter
{
    public void OnException(ExceptionContext context)
    {
        // 构造自定义500响应，可替换为更友好的提示文本
        context.Result = new ObjectResult("服务器内部错误")
        {
            StatusCode = StatusCodes.Status500InternalServerError
        };
        // 标记异常已处理，阻止框架返回默认堆栈跟踪
        context.ExceptionHandled = true;
    }
}

在启动类中注册过滤器：

// .NET 6+ In-Process 示例
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddMvc(options =>
{
    options.Filters.Add<HideStacktraceExceptionFilter>();
});

2. 单个函数局部捕获

如果只需要处理特定函数，直接在函数逻辑中包裹try-catch：

[FunctionName("GetPdfBlob")]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", Route = null)] HttpRequest req,
    ILogger log)
{
    try
    {
        // 从Blob存储读取PDF的业务逻辑
        var pdfBytes = await FetchPdfFromBlob();
        return new FileContentResult(pdfBytes, "application/pdf");
    }
    catch (Exception ex)
    {
        // 仅记录日志，不对外暴露异常细节
        log.LogError(ex, "读取PDF文件失败");
        // 返回纯500状态码，或自定义提示
        return new StatusCodeResult(StatusCodes.Status500InternalServerError);
    }
}

针对Isolated模型（.NET 6+） #

通过中间件全局处理异常：

using Microsoft.AspNetCore.Http;
using System.Net;

public class ExceptionHandlingMiddleware
{
    private readonly RequestDelegate _next;
    private readonly ILogger<ExceptionHandlingMiddleware> _logger;

    public ExceptionHandlingMiddleware(RequestDelegate next, ILogger<ExceptionHandlingMiddleware> logger)
    {
        _next = next;
        _logger = logger;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        try
        {
            await _next(context);
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "请求处理异常");
            // 重置响应并返回干净的500结果
            context.Response.Clear();
            context.Response.StatusCode = (int)HttpStatusCode.InternalServerError;
            context.Response.ContentType = "text/plain";
            await context.Response.WriteAsync("服务器内部错误");
        }
    }
}

在Program.cs中注册中间件：

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

host.Run();

其他注意事项 #

• 无论哪种方式，务必通过ILogger记录完整异常信息，方便后续排查socket耗尽等问题
• 如果是Python/JavaScript函数，逻辑类似：用try-catch包裹业务代码，捕获异常后仅返回500状态码，不输出堆栈信息

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