如何在错误场景下向Azure Function自定义处理程序投递日志并保留重试

问题描述 #

Azure Functions的自定义处理程序以Web服务器形式运行，接收主机转发的输入绑定，响应会被转发到function.json定义的端点。正常场景下返回20X状态码及指定格式JSON（含Outputs、Logs、ReturnValue）可正常运行，但错误场景存在两难：

• 未处理错误无响应，导致应用日志丢失
• 返回500/40X状态码并携带Logs的响应会被主机拒收，仅能看到主机生成的"响应状态码非成功"错误，无法获取应用级错误日志；虽能触发重试，但缺少排查依据。

需求：实现受控错误响应，既能触发重试，又能在调用日志中保留应用级日志，达到官方SDK的表现。

解决方案 #

核心逻辑是返回20X成功状态码，同时在响应Payload中标记执行失败并传递错误日志，让Functions主机识别失败并触发重试，同时完整保留应用日志。

具体实现 #

1. 固定返回20X状态码：无论是否发生错误，都返回200/202等成功状态码，确保主机接收并解析响应中的Logs字段。
2. 在响应中传递错误信息：
   • 在Logs数组中写入详细的应用级错误日志（如错误类型、详情、堆栈信息）
   • 通过ReturnValue或自定义字段明确标记执行失败（比如{"success": false, "error": "具体错误信息"}）
3. 配置触发器重试策略：结合触发器类型（如队列、服务总线）在function.json中配置重试规则，确保主机识别失败后触发重试。

示例错误响应 #

{
  "Outputs": {},
  "Logs": [
    "错误类型：数据库连接超时",
    "错误详情：无法连接到订单数据库，超时时间30秒",
    "堆栈跟踪：at xxxService.Connect() in /path/to/file.cs:line 45"
  ],
  "ReturnValue": "{\"success\": false, \"errorMessage\": \"数据库连接异常，请检查配置\"}"
}

触发重试的关键配置 #

对于队列类触发器，需在function.json中配置重试策略，示例：

{
  "bindings": [
    {
      "type": "queueTrigger",
      "direction": "in",
      "name": "myQueueItem",
      "queueName": "my-queue",
      "connection": "AzureWebJobsStorage",
      "maxDequeueCount": 5,
      "visibilityTimeout": "00:05:00"
    }
  ]
}

当自定义处理程序返回上述失败标记的响应后，主机会判定执行失败，按照配置的重试规则重新处理消息，同时Logs中的内容会被完整记录到调用日志中。

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