Terraform：如何通过template file指定APIGateway的invoke_url？

核心错误原因 #

你遇到的问题本质是模板变量名与传入的键名不匹配：模板文件中引用的是backend_api_gateway，但templatefile函数传入的键名是backend_api_url，导致Terraform找不到对应变量。另外，变量默认值不能引用资源属性的问题，是因为Terraform变量初始化阶段无法获取apply阶段才生成的资源属性值。

修正方案 #

1. 保持模板文件变量名不变 #

你的vote/index.html.tpl文件中变量名是backend_api_gateway，继续保留：

<!DOCTYPE html>
<html>
  <!-- 原有代码 -->
      
  var backend_url = "${backend_api_gateway}/voting"               

  <!-- 原有代码 -->
</html>

2. 修正Terraform资源配置 #

确保templatefile传入的键名与模板中的变量名完全一致，直接引用APIGateway阶段的invoke_url即可（无需额外locals，保留locals也可以）：

# 可选：使用locals统一管理（也可以直接在templatefile中引用资源）
locals {
  backend_api_gateway = aws_apigatewayv2_stage.default.invoke_url
}

resource "aws_s3_object" "index_file_vote" {
  bucket = aws_s3_bucket.frontend_vote.id
  key    = "index.html"
  content = templatefile("./vote/index.html.tpl", {
    # 键名必须和模板中的变量名一致：backend_api_gateway
    backend_api_gateway = local.backend_api_gateway
    # 或者直接省略locals，写为：backend_api_gateway = aws_apigatewayv2_stage.default.invoke_url
  })
  
  depends_on = [aws_s3_bucket.frontend_vote, aws_apigatewayv2_api.main_apigateway] 
}

3. 避免变量定义的错误用法 #

Terraform变量的默认值只能是静态字符串，不能引用资源属性（资源属性是apply阶段生成的，变量初始化阶段无法获取），所以之前的变量定义写法是无效的，直接通过资源引用或locals传递即可。

关键注意点 #

• Terraform引用资源属性时，不需要用"${}"包裹，直接写aws_apigatewayv2_stage.default.invoke_url即可，语法更简洁。
• local.backend_api_gateway will be known only after apply只是提示信息，不是错误原因，Terraform允许在模板中使用apply阶段才会确定的值。

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