COS 触发、定时触发、云 API 异步调用失败之后,平台会自己再执行。把重试次数调低,只能减少代码抛错、超时、内存超限这一类运行错误的自动重试。432、429、449、500 不看这个次数,按最长保留时间继续重试,默认 6 小时,间隔 1 分钟。
云 API 同步调用、CLB 触发器、函数 URL 出错后,错误直接回到调用方,平台不重试。要不要再打,是调用方的策略。
CKafka、Apache Kafka 触发器的调用是同步的,重试却由云函数侧控制:运行错误以及 429、432、449 按配置次数、每分钟一次;500 指数退避,直到成功。MQTT 更宽,429、432、449、500 都是指数退避直到成功。退避的底数和上限文档没写,不要自己补间隔。这几类触发器上的 500 没有到次数就放弃的一档。
异步调用包括云 API 异步调用、COS 触发器、定时触发器、CMQ Topic 触发器。并发超限页把 CLS、MPS 触发器也列在异步调用里。这条路径分成下面两节,不要和 Kafka 触发器混用。
创建时在高级设置里勾选的「异步执行」不是异步调用。只能创建时选定,之后不能改。调度完立刻返回 RequestId,结果要函数自己回调。执行过程中的错误不吃重试和死信,异常会回收实例。执行上限 24 小时,调用 QPS 1000,超出直接失败。
异步调用的重试次数只适用于运行错误,默认 2 次,间隔 1 分钟。字段是 RetryConfig 里的 RetryNum。用户代码异常(430、443)、执行超时(433)、内存超限(434)、进程退出(439)都在这一类。433、434、439 还会回收实例,下一次重试在新实例上跑,不是在原进程里续跑。
433 只表示配置的执行时间内没有跑完,不表示业务写还没提交。超时前已经把订单写成已支付,一分钟后再调一次就会再写一遍。调低重试次数挡不住调用方自己再调,也挡不住下一节的超限重试。
运行错误重试的同时,新的触发事件仍然会进来。失败的是这一条事件,不会把后面的事件堵住。
下面四类不看 RetryNum,按最长保留时间重试,默认 6 小时,间隔仍是 1 分钟。配了死信的,超过保留时间仍失败就进死信;没配就丢弃。判定方法:重试时刻减去首次触发时刻,大于最长保留时间即超出。
状态码 | 含义 | 异步调用怎么重试 |
|---|---|---|
500 | 平台内部错误 | 按保留时间,每分钟一次 |
432 | 并发额度用尽 | 按保留时间,每分钟一次 |
429 | 扩容速度(burst)超限 | 按保留时间,每分钟一次 |
449 | 地域内没有所选规格的资源 | 按保留时间,每分钟一次 |
并发额度按内存算,不是按请求个数。广州、上海、北京、成都、中国香港每个地域默认 128000 MB;新加坡、东京、硅谷、法兰克福、深圳金融、上海金融是 64000 MB。地域之间不共用。1024 MB 的函数,128000 MB 大约相当于 125 个同时在跑的实例,这是额度换算,不是压测结果。内存最小 64 MB,从 128 MB 起按 128 MB 递增,默认上限 3072 MB。大规格要另行申请,不要把申请后的上限写成默认配额。
其中 12800 MB 不能划给单个函数,留给没设最大独占配额的函数共用。最大独占配额是该函数所有版本的并发上限,划走之后其他函数用不到。设成 0 等于关停,所有请求都会并发超限。删除最大独占配额是回到共享池,不是关停。预置并发不在这套配额里,只是提前拉起实例;同一函数的各个版本仍共享该函数的并发额度。
429 和 432 不要混。burst 默认每个地域每分钟 500 个新容器,来不及创建就返回 429。432 是正在跑的并发内存超过了独占配额,或超过地域里还没被独占走的剩余额度。异步调用碰到这两种,平台在保留时间内继续重试,调用方往往只看到提交成功。同步调用碰到 432,平台不重试,错误直接返回。
按默认 6 小时、1 分钟一次估算,一条 432 大约还能再执行 360 次。这是时间窗换算,停止条件是时间差,不是固定次数。每次重试都占一次执行。保留时间没缩短时,打满之后的失败事件会在后面几个小时里把额度再打满一轮。
异步事件本体上限 128 KB,超限是 406,发生在执行前,重试不会把事件变小。同步请求上限 6 MB,不要拿来估异步触发。异步事件队列最大 10 万条。超出后是拒绝新事件还是挤掉旧事件,两页都没写。
数据结构示例里出现过 MsgTTL 为 21600、RetryNum 为 2,和默认 6 小时、2 次对得上,21600 按秒算就是 6 小时。字段说明只写「消息保留时间」,没写单位。控制台如果按小时展示,不要把 6 填进 MsgTTL。GetFunctionEventInvokeConfig 的返回示例里,RetryConfig 还有第二项 RetryNum 为 -1,说明没有解释,不要理解成无限重试,更新时也不要删掉。
死信页写的投递条件是:运行错误重试 2 次仍失败;超限和系统错误重试超过 24 小时;异步队列堆积达到上限。重试策略页写的是可配置次数(默认 2)和可配置保留时间(默认 6 小时)。两页对「超限要扛多久」不一致,死信页也没跟上「次数可改」。
排期以函数上的配置为准,用 GetFunctionEventInvokeConfig 读 MsgTTL 和 RetryNum。不要按 24 小时去估一条 432 还会执行多久。
死信目前内测,文档要求工单开通 CMQ,支持队列和主题。主题要收到全部错误,标签筛选留空,BindingKey 填 #。别名的死信跟随主版本。投递还会因权限、队列配错、消息超限失败,监控项是「死信队列投递失败次数」,这是投递失败,不是业务失败。没配死信时,超限事件被丢弃,监控里看不到「已丢弃」。
死信消息里有 RequestId、ErrorCode、ErrorMessage,消息体里有 RetryNum 和 Ttl。定时触发的 ClientContext 示例带 Time,用来对上是哪一次触发,不是业务单号。
异步提交成功只说明事件进了队列。调用方等不到回调就再调一次,平台对原事件也在按分钟重试,同一笔业务变成两个事件,重试次数对第二个事件重新计数。
幂等键用业务单号,或定时触发自带的触发时间。不要用当次 RequestId,重试是否复用同一次请求 ID,文档没写死。键要落在函数外的存储上,433 会回收实例。条件写入必须由存储保证。抢占成功后业务又失败的,不要删键,否则一分钟后会再执行,交给死信或人工。过期时间要长于该函数的 MsgTTL。
import os
import redis
def main_handler(event, context):
key = (event or {}).get("idempotency_key")
if not isinstance(key, str) or not key:
raise ValueError("missing idempotency_key")
client = redis.Redis(
host=os.environ["REDIS_HOST"],
port=int(os.environ.get("REDIS_PORT", "6379")),
password=os.environ.get("REDIS_PASSWORD") or None,
socket_connect_timeout=1,
socket_timeout=1,
decode_responses=True,
)
claimed = client.set("scf:idem:" + key, "1", nx=True, ex=86400)
if not claimed:
return {"duplicated": True, "key": key}
return {"duplicated": False, "key": key}函数要能访问这台 Redis。连接超时 1 秒,避免幂等存储把执行拖进 433。ex=86400 只是长于默认 6 小时的示例。业务写放在 set 返回真值之后,上面只演示抢占。
返回 OK 是本次抢到,返回空是已经有人占过。这不能代替函数里的判断。
redis-cli -h 10.0.0.12 -p 6379 SET scf:idem:order-10001 1 NX EX 86400读接口可以带 Qualifier,默认 $LATEST。更新接口只有函数名、命名空间和 AsyncTriggerConfig,没有版本号。不要假设每个版本一份配置;不同 Qualifier 各读一次,一样就按函数级处理。
tccli scf GetFunctionEventInvokeConfig \
--region ap-guangzhou \
--cli-input-json '{"FunctionName":"order-settle","Namespace":"default","Qualifier":"$LATEST"}'更新时把读到的 RetryConfig 原样带上,只改要改的字段。官方更新示例只传一项,直接套用会把第二项盖掉。下面这条只在「读出来只有一项,且确认 MsgTTL 单位是秒」时使用:
tccli scf UpdateFunctionEventInvokeConfig \
--region ap-guangzhou \
--cli-input-json '{"FunctionName":"order-settle","Namespace":"default","AsyncTriggerConfig":{"MsgTTL":21600,"RetryConfig":[{"RetryNum":2}]}}'报 LimitExceeded.MsgTTL 或 LimitExceeded.RetryNum,是超出账号侧允许范围。产品页没写死上限,不要把 21600 再提交一遍。
超限看监控信息里的「受限次数」,以及调用日志里的「调用超限」。运行错误看普通调用日志的状态码,日志结构里有 RetryNum,不要到「调用超限」里找 433。ListAsyncEvents 是异步执行事件,状态为 RUNNING、FINISHED、ABORTED、FAILED,不能用来判断普通异步调用还在不在重试。
上线前对一下:
RetryNum 和 MsgTTL 是读出来的值。CKafka、Apache Kafka、MQTT 上的 500 不看 RetryNum。MsgTTL。原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。