如何手动标记Timer触发的Azure Function执行失败？

场景 #

我有一个Timer触发器的Azure Function，包含多个独立执行步骤。每个步骤都用try/catch块包裹，捕获异常并记录日志，确保单个步骤失败不会终止整个函数：

try { await StepOneAsync(); }
catch (Exception ex) { logger.LogError(ex, "Step one failed"); }

try { await StepTwoAsync(); }
catch (Exception ex) { logger.LogError(ex, "Step two failed"); }

需求 #

当任意步骤执行失败时，希望Azure将该Function标记为执行失败，以便触发内置告警，并在调用记录中查看失败状态。需要在所有步骤执行完成后，以非临时方案的方式手动标记函数执行失败。

已尝试方案 #

曾为每个步骤设置成功标记，在函数末尾抛出虚构异常触发失败：

var stepOneSucceeded = false;
try 
{ 
    await StepOneAsync(); 
    stepOneSucceeded = true;
}
catch (Exception ex) { logger.LogError(ex, "Step one failed"); }

var stepTwoSucceeded = false;
try 
{ 
    await StepTwoAsync(); 
    stepTwoSucceeded = true;
}
catch (Exception ex) { logger.LogError(ex, "Step two failed"); }

if (!stepOneSucceeded || !stepTwoSucceeded) throw new Exception("Steps failed");

但这种方式属于临时 workaround，并非最优方案。

最优解决方案 #

Azure Function的执行失败状态是通过未处理的异常来触发的，我们可以收集所有步骤的异常，最后抛出AggregateException来聚合所有错误，既保留完整的错误上下文，又能让Azure正确标记执行失败：

代码示例 #

var encounteredExceptions = new List<Exception>();

// 执行步骤1并捕获异常
try 
{ 
    await StepOneAsync(); 
}
catch (Exception ex) 
{ 
    logger.LogError(ex, "Step one failed");
    encounteredExceptions.Add(ex);
}

// 执行步骤2并捕获异常
try 
{ 
    await StepTwoAsync(); 
}
catch (Exception ex) 
{ 
    logger.LogError(ex, "Step two failed");
    encounteredExceptions.Add(ex);
}

// 如果有异常，抛出聚合异常
if (encounteredExceptions.Any())
{
    throw new AggregateException("一个或多个步骤执行失败", encounteredExceptions);
}

方案优势 #

1. 保留完整错误信息：AggregateException会包含所有步骤的具体异常，便于后续排查问题，比虚构的通用Exception更有价值。
2. 符合Azure官方逻辑：通过未处理异常标记失败是Azure Function的标准机制，不属于临时 workaround。
3. 触发内置告警：函数执行失败状态会被Azure正确识别，触发你配置的内置告警规则。
4. 调用记录可见：在Azure门户的函数调用记录中，会清晰显示执行失败状态，同时可以查看完整的异常堆栈信息。

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