如何让功能失效的Azure Function执行状态显示为failed？

我之前遇到过一模一样的场景——捕获了异常但Function还是显示成功，运维排查起来特别头疼。要解决这个问题，核心就是让Azure明确知道你的Function执行出了问题，下面是几个实用的办法：

1. 重新抛出捕获的异常 #

这是最直接的方式：在你的catch块里完成必要的日志记录后，重新抛出异常。Azure Function runtime会检测到未处理的异常，自动将执行状态标记为Failed。

举个C#的示例：

using Microsoft.Extensions.Logging;

public static void Run(string input, ILogger log)
{
    try
    {
        // 这里是你的业务逻辑，比如使用connection string访问资源
        var result = AccessResourceWithConnectionString();
    }
    catch (Exception ex)
    {
        // 记录详细错误日志，方便后续排查
        log.LogError(ex, "Function执行过程中发生致命错误");
        // 重新抛出异常，让Azure标记执行失败
        throw;
    }
}

如果是Python的Function，代码类似：

import logging
import azure.functions as func

def main(req: func.HttpRequest) -> func.HttpResponse:
    try:
        # 业务逻辑代码
        process_data()
    except Exception as ex:
        logging.error(f"执行出错: {str(ex)}", exc_info=True)
        # 重新抛出异常
        raise

2. 通过上下文对象明确标记失败（针对部分触发器） #

对于一些触发器（比如Queue、Blob触发器），你可以使用Function的上下文对象来主动标记执行失败。

比如Node.js的示例：

module.exports = async function (context, myQueueItem) {
    try {
        // 处理队列消息的业务逻辑
        processQueueItem(myQueueItem);
    } catch (ex) {
        context.log.error(`处理队列消息失败: ${ex.message}`);
        // 调用context.done并传入true，标记执行失败
        context.done(true);
    }
};

在旧版C# Function模型中，也可以使用context.Fail(ex)方法：

public static void Run(string myQueueItem, TraceWriter log, ExecutionContext context)
{
    try
    {
        // 业务逻辑
    }
    catch (Exception ex)
    {
        log.Error($"执行失败: {ex.Message}");
        // 标记执行失败
        context.Fail(ex);
    }
}

3. HTTP触发器返回错误状态码 #

如果你的Function是HTTP触发的，除了抛出异常，还可以直接返回5xx系列的HTTP状态码。这样不仅客户端能收到错误响应，Azure也会将这次执行标记为Failed。

示例（C#）：

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;

public static IActionResult Run(HttpRequest req, ILogger log)
{
    try
    {
        // 业务逻辑
        var data = FetchData();
        return new OkObjectResult(data);
    }
    catch (Exception ex)
    {
        log.LogError(ex, "HTTP Function执行失败");
        // 返回500错误，标记执行失败
        return new StatusCodeResult(StatusCodes.Status500InternalServerError);
    }
}

额外建议：配置Azure Monitor告警 #

完成上述设置后，建议运维团队配置Azure Monitor的失败执行警报——当Function出现失败状态时，自动发送邮件/短信通知，这样不用逐个查看日志就能第一时间发现故障。

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