Terraform如何在template_file中插值map类型？遇类型不匹配报错求解决

你遇到的报错核心原因是：Terraform的template_file数据源对vars参数有严格类型限制——每个变量必须是字符串类型，但你直接传入了map[string]interface{}类型的值，类型不匹配导致触发错误。下面给你几种可行的解决方案：

方案1：将Map转为JSON字符串传入，模板内解析 #

适合需要传递整个Map的场景，通过jsonencode把Map序列化为JSON字符串，传入模板后再用jsondecode解析还原：

修改template_file数据源 #

data "template_file" "app" {
  template = file("./app_template.tpl")
  vars = {
    # 把map转成JSON字符串传入
    container = jsonencode(var.container-configuration)
  }
}

在模板文件app_template.tpl中解析使用 #

%{ /* 先将JSON字符串解析回map */ }
%{ container_map = jsondecode(container) }
Image: ${container_map.image}
Container Port: ${container_map["container-port"]}
Host Port: ${container_map["host-port"]}
CPU Limit: ${container_map.cpu}
Memory Limit: ${container_map.memory}
Log Group: ${container_map["log-group"]}
Log Region: ${container_map["log-region"]}

方案2：逐个传入Map的键值对 #

如果模板只需要Map中的部分字段，或者不想处理JSON，可以直接把Map的每个键值对单独作为字符串传入vars：

data "template_file" "app" {
  template = file("./app_template.tpl")
  vars = {
    image          = var.container-configuration.image
    container_port = var.container-configuration["container-port"]
    host_port      = var.container-configuration["host-port"]
    cpu            = var.container-configuration.cpu
    memory         = var.container-configuration.memory
    log_group      = var.container-configuration["log-group"]
    log_region     = var.container-configuration["log-region"]
  }
}

对应的模板可以直接使用这些变量：

Image: ${image}
Container Port: ${container_port}
Host Port: ${host_port}
CPU Limit: ${cpu}
Memory Limit: ${memory}

更推荐的方案：使用templatefile函数（Terraform 0.12+） #

如果你使用的是Terraform 0.12及以上版本，官方更推荐用内置的templatefile函数替代template_file数据源——它支持直接传入复杂类型（包括Map），无需额外转换，代码更简洁：

locals {
  # 直接传入整个map变量到模板
  app_template_content = templatefile("./app_template.tpl", {
    container = var.container-configuration
  })
}

模板里可以直接使用这个Map：

Image: ${container.image}
Container Port: ${container["container-port"]}
Host Port: ${container["host-port"]}

这种方式更符合现代Terraform的用法习惯，也能避免类型转换的麻烦。

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