Bash部署Lambda时如何重试AWS CLI命令直至执行成功

AI 小北

2026-8-30

问题根因

ResourceConflictException是Lambda的默认保护规则：单个Lambda同一时间仅允许执行一个更新类操作（含代码更新、配置修改、版本发布等），前一个操作未完成时发起新的更新请求就会返回该错误。批量部署时直接串行循环发起更新请求，很容易在前一次更新未落地时触发下一次请求，命中冲突。

最初写出的重试逻辑存在几处语法和逻辑缺陷，无法正常运行：

[ ]是Shell内置的test判断命令，不能把AWS CLI命令直接写在[ ]内部，Shell会把CLI命令当成test的参数解析，根本不会实际执行CLI调用
脚本开头配置了set -euo pipefail严格模式的情况下，CLI命令一旦返回非0退出码，脚本会直接终止，根本走不到后面的重试分支
没有做错误类型区分：如果是参数错误、权限不足这类和资源冲突无关的报错，盲目重试只会浪费部署时间
1分钟的重试间隔过长，Lambda常规更新仅需5-20秒，过长等待会拖慢整个部署流程

可直接落地的实现代码

以下代码完全兼容set -euo pipefail配置，不需要全局关闭严格模式，同时仅针对资源冲突错误重试，其他类型错误会直接抛出：

#!/bin/bash
set -euo pipefail

# Lambda部署重试函数：传入的所有参数会直接透传给aws lambda update-function-code命令
deploy_lambda() {
  local max_retry=10
  local interval=15 # 每15秒重试一次，最长等待2.5分钟，足够覆盖绝大多数Lambda更新场景
  local attempt=1
  local output

  while [ $attempt -le $max_retry ]; do
    # 临时关闭-e选项，捕获CLI执行结果，避免非0退出码直接终止脚本
    set +e
    output=$(aws lambda update-function-code "$@" 2>&1)
    local exit_code=$?
    set -e # 立刻恢复严格模式，不影响其他逻辑的错误检查

    if [ $exit_code -eq 0 ]; then
      echo "Lambda部署成功"
      echo "$output"
      return 0
    fi

    # 仅对资源冲突错误触发重试
    if echo "$output" | grep -q "ResourceConflictException"; then
      echo "检测到Lambda处于更新中状态，第${attempt}次重试，等待${interval}秒..."
      sleep $interval
      attempt=$((attempt + 1))
    else
      echo "Lambda部署遇到不可重试错误："
      echo "$output"
      return $exit_code
    fi
  done

  echo "重试${max_retry}次后部署仍然失败，最后一次错误信息："
  echo "$output"
  return 1
}

# 批量部署逻辑示例，替换为实际的文件读取规则即可
# 示例假设待部署的Lambda列表存放在lambda_list.txt中，每行对应一个函数名
while IFS= read -r func_name || [ -n "$func_name" ]; do
  # 跳过空行/纯空格行
  [ -z "$(echo "$func_name" | xargs)" ] && continue
  echo "开始部署Lambda函数: ${func_name}"
  # 替换为实际的CLI参数，比如--s3-bucket、--zip-file、--publish等
  deploy_lambda --function-name "$func_name" --s3-bucket your-deployment-bucket --s3-key "lambda-artifacts/${func_name}.zip"
done < "lambda_list.txt"

实现注意事项与优化方案

必须过滤可重试错误：不要对所有非0退出码都做重试，遇到权限不足、参数非法这类永久性错误时，重试多少次都不会成功，只会拖慢CodeBuild任务的失败反馈速度
重试参数按需调整：如果部署的是配置了VPC、挂载了多版本层的Lambda，更新耗时会更长，可以适当把重试间隔调整为20秒、最大重试次数调到15次，总等待5分钟足够覆盖所有极端场景
文件遍历避坑：读取文件行必须用IFS= read -r写法，避免行内容里的空格、特殊字符被Shell意外转义；循环末尾加|| [ -n "$func_name" ]是为了兼容文件最后一行没有换行符的场景，不会漏掉最后一个待部署函数
前置检查减少无效重试：如果要进一步降低重试概率，可以在发起更新请求前先调用aws lambda get-function-configuration --function-name <函数名>查询LastUpdateStatus字段，如果值为InProgress就先等待，从根源减少冲突请求
跨任务调度注意：如果CodeBuild配置了并行部署任务，要做好资源调度，避免不同任务同时更新同一个Lambda，否则重试逻辑也可能因为超过最大等待时间部署失败

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