使用Terraform实现AWS API Gateway阶段变量集成Lambda时的循环依赖问题

这个循环依赖的根源是你在Lambda集成配置里直接引用了Terraform的阶段资源变量，导致集成依赖阶段、阶段依赖部署、部署依赖集成的死循环。要实现一次无缝部署，核心是打破这个循环链，具体做法如下：

核心思路 #

不要在集成配置中通过Terraform引用阶段变量资源，而是直接使用API Gateway原生的阶段变量占位符字符串（${stageVariables.xxx}）。这样集成配置不依赖阶段资源，只需要静态字符串，就能让部署→阶段的依赖链变成线性，而非循环。

具体Terraform代码示例 #

1. 定义API Gateway基础资源 #

resource "aws_api_gateway_rest_api" "my_api" {
  name        = "MyLambdaAPI"
  description = "API集成Lambda，使用阶段变量实现金丝雀发布"
}

resource "aws_api_gateway_resource" "test_resource" {
  rest_api_id = aws_api_gateway_rest_api.my_api.id
  parent_id   = aws_api_gateway_rest_api.my_api.root_resource_id
  path_part   = "test"
}

resource "aws_api_gateway_method" "post_method" {
  rest_api_id   = aws_api_gateway_rest_api.my_api.id
  resource_id   = aws_api_gateway_resource.test_resource.id
  http_method   = "POST"
  authorization = "NONE"
}

2. 配置Lambda集成（用阶段变量占位符） #

这里的URI直接写${stageVariables.lambda_arn}，不需要引用Terraform的阶段资源：

resource "aws_api_gateway_integration" "lambda_proxy" {
  rest_api_id             = aws_api_gateway_rest_api.my_api.id
  resource_id             = aws_api_gateway_resource.test_resource.id
  http_method             = aws_api_gateway_method.post_method.http_method
  integration_http_method = "POST"
  type                    = "AWS_PROXY"
  # 直接用API Gateway原生阶段变量占位符，不依赖Terraform阶段资源
  uri                     = "arn:aws:apigateway:${var.aws_region}:lambda:path/2015-03-31/functions/${stageVariables.lambda_arn}/invocations"
}

3. 创建API部署（避免自动生成阶段） #

设置stage_name为空，防止Terraform自动创建阶段，我们手动创建阶段来控制变量：

resource "aws_api_gateway_deployment" "api_deployment" {
  depends_on = [aws_api_gateway_integration.lambda_proxy]
  rest_api_id = aws_api_gateway_rest_api.my_api.id
  stage_name  = "" # 空值避免自动生成阶段
}

4. 创建阶段并配置变量（含金丝雀发布） #

这里阶段依赖部署ID，同时定义阶段变量和金丝雀的变量覆盖：

resource "aws_api_gateway_stage" "prod_stage" {
  rest_api_id    = aws_api_gateway_rest_api.my_api.id
  deployment_id  = aws_api_gateway_deployment.api_deployment.id
  stage_name     = "prod"

  # 主流量指向的Lambda ARN
  variables = {
    lambda_arn = aws_lambda_function.prod_lambda.arn
  }

  # 金丝雀配置：10%流量指向金丝雀版本Lambda
  canary_settings {
    percent_traffic         = 10
    stage_variable_overrides = {
      lambda_arn = aws_lambda_function.canary_lambda.arn
    }
    use_stage_cache = false
  }
}

5. 配置Lambda调用权限 #

给API Gateway授予调用Lambda的权限，注意这里的source_arn会自动依赖阶段资源，Terraform能正确处理：

# 主Lambda权限
resource "aws_lambda_permission" "api_gateway_prod" {
  statement_id  = "AllowAPIGatewayProdInvoke"
  action        = "lambda:InvokeFunction"
  function_name = aws_lambda_function.prod_lambda.function_name
  principal     = "apigateway.amazonaws.com"
  source_arn    = "${aws_api_gateway_rest_api.my_api.execution_arn}/${aws_api_gateway_stage.prod_stage.stage_name}/*"
}

# 金丝雀Lambda权限
resource "aws_lambda_permission" "api_gateway_canary" {
  statement_id  = "AllowAPIGatewayCanaryInvoke"
  action        = "lambda:InvokeFunction"
  function_name = aws_lambda_function.canary_lambda.function_name
  principal     = "apigateway.amazonaws.com"
  source_arn    = "${aws_api_gateway_rest_api.my_api.execution_arn}/${aws_api_gateway_stage.prod_stage.stage_name}/*"
}

关键说明 #

• 这样的配置形成了API资源/方法 → Lambda集成 → 部署 → 阶段的线性依赖，完全没有循环。
• 阶段变量在API Gateway运行时生效，Terraform只负责写入变量值，不需要在集成配置时提前知道变量内容。
• 金丝雀发布直接通过阶段的canary_settings覆盖变量即可，不需要修改集成或部署配置，完全符合阶段变量的设计初衷。

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