Terraform新增API Gateway端点后部署未更新问题排查

首先明确：你确实误解了module.api_endpoint[*]的取值逻辑，并且需要通过模块输出关键变更内容才能实现预期的自动部署触发。

核心问题解析 #

• module.api_endpoint[*]仅引用模块实例的集合标识，Terraform不会自动追踪模块内部的API Gateway资源（如aws_api_gateway_resource、aws_api_gateway_method）变更。模块本身的"身份"不会因为内部资源修改而改变，因此直接用它作为触发器无法感知端点的新增或修改。
• 若模块未显式输出与端点配置相关的具体变更属性，aws_api_gateway_deployment的triggers参数无法捕获到有效变化，自然不会触发重新部署。

正确实现步骤 #

1. 调整api_endpoint模块的输出 #

在模块内部，输出所有影响API部署的关键资源ID，确保任何端点变更都能被外部感知：

output "resource_ids" {
  type        = list(string)
  description = "API Gateway 资源ID列表"
  value       = aws_api_gateway_resource.this[*].id
}

output "method_ids" {
  type        = list(string)
  description = "API Gateway 方法ID列表"
  value       = aws_api_gateway_method.this[*].id
}

# 若模块包含集成、模型等资源，需补充对应输出
output "integration_ids" {
  type        = list(string)
  description = "API Gateway 集成ID列表"
  value       = aws_api_gateway_integration.this[*].id
}

2. 重新配置Deployment的触发器 #

在根模块中，收集所有api_endpoint实例的输出值，生成唯一哈希作为触发器条件：

resource "aws_api_gateway_deployment" "main" {
  rest_api_id = aws_api_gateway_rest_api.main.id
  stage_name  = "prod"

  triggers = {
    # 合并所有模块的关键资源ID，生成唯一哈希值
    redeployment = sha1(join(",", flatten([
      module.api_endpoint[*].resource_ids,
      module.api_endpoint[*].method_ids,
      module.api_endpoint[*].integration_ids
    ])))
  }

  lifecycle {
    create_before_destroy = true
  }
}

• flatten用于将嵌套列表转为一维结构，确保所有资源ID都能被拼接。
• sha1生成的哈希值会在任何资源ID变化时更新，从而触发Deployment重新创建。
• create_before_destroy配置避免部署过程中出现API服务中断。

3. 额外注意点 #

• 所有影响API行为的资源（如请求验证器、模型）都需要加入触发器的哈希计算。
• 若模块支持动态创建多个端点，确保输出的列表能正确包含所有实例的资源ID。

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