如何避免Azure Function因内部API返回400错误被重复调用

核心原因说明 #

你遇到的重复触发本质是重试机制被触发：第三方Webhook服务、Azure Function运行时只要收到非成功状态码或捕获到未处理异常时，都会默认判定本次请求执行失败，触发重试逻辑。你内部预期返回400的API调用如果没有做异常捕获，异常会直接冒泡到函数运行时，导致函数返回非2xx状态码，进而触发重试。

具体修复步骤 #

• 针对预期返回400的API调用单独做异常捕获，禁止异常冒泡到函数运行时。只需在调用该API的位置包裹异常捕获逻辑，处理完对应的业务逻辑后继续执行后续代码即可，示例代码如下（以Python为例）：

import requests
import logging

# 调用固定返回400的目标API
try:
    resp = requests.post("你的目标API地址", json=请求参数)
    resp.raise_for_status()
except requests.exceptions.HTTPError as err:
    if resp.status_code == 400:
        # 此处处理对应正常业务逻辑，仅需记录日志即可，不要抛出异常
        logging.info("收到预期400返回，业务逻辑处理完成")
    else:
        # 非预期的其他HTTP错误按原有逻辑处理
        raise err

• 强制函数最终返回2xx状态码给Webhook调用方。不管内部业务逻辑处理完成后是否存在预期业务错误，都给触发的第三方Webhook服务返回200状态码，告知对方请求已成功接收处理，避免第三方发起重试。
• 关闭Azure Function触发器的内置重试策略。如果你的函数配置了自动重试，可以在项目根目录的host.json文件中修改配置，禁用HTTP触发器的重试策略，示例配置如下：

{
  "version": "2.0",
  "extensions": {
    "http": {
      "retry": {
        "strategy": "none"
      }
    }
  }
}

• 新增幂等性校验兜底。如果第三方Webhook服务本身有强制重试规则无法修改，你可以给每个Webhook请求生成唯一标识，将已处理过的请求标识存入缓存，每次收到请求先校验是否已处理过，已处理的直接返回成功即可，避免重复执行业务逻辑。

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