Terraform apply报template_file的vars元素需为字符串错误求助

template_file数据源的vars参数有明确类型约束：传入的键值对中所有值必须为字符串类型，不支持直接传入map、list等复合结构。你当前配置中直接将local.controllers这个嵌套map对象赋值给controller_ip，类型不匹配，因此触发Inappropriate value for attribute vars element string required报错。

• 核对Terraform官方文档中template_file的参数要求，确认vars块仅接受字符串类型值
• 检查local.controllers的实际类型：你定义的controllers是包含3个嵌套对象的map结构，每个对象下携带host_name、vm_ip两个属性，属于复合类型，不符合参数要求
• 先明确cloud-init模板中controller_ip占位符需要的实际字符串格式：是逗号分隔的IP列表、换行分隔的配置段，还是结构化的主机映射，再对应做类型转换

提示：Terraform 0.12及以上版本更推荐使用内置templatefile()函数替代老旧的template_file数据源，二者变量类型规则完全一致，写法更简洁。

根据模板的实际需求选择对应处理方式：

场景1：模板仅需要控制器IP列表（如负载均衡upstream配置） #

先从local.controllers中提取IP字段，拼接为模板需要的字符串格式后再传入。
例如你需要拼接为192.168.1.87,192.168.1.88,192.168.1.89这种逗号分隔格式，可以先在locals中做预处理：

locals {
  # 原有workers、controllers定义保留
  workers = {
    "worker-1" = { host_name = "wrkr-1", vm_ip = "90" }
    "worker-2" = { host_name = "wrkr-2", vm_ip = "91" }
    "worker-3" = { host_name = "wrkr-3", vm_ip = "92" }
    "worker-4" = { host_name = "wrkr-4", vm_ip = "93" }
    "worker-5" = { host_name = "wrkr-5", vm_ip = "94" }
    "worker-6" = { host_name = "wrkr-6", vm_ip = "95" }    
  }
  controllers = {
    "controllers-1" = { host_name = "ctrl-1", vm_ip = "87" }
    "controllers-2" = { host_name = "ctrl-2", vm_ip = "88" }
    "controllers-3" = { host_name = "ctrl-3", vm_ip = "89" }
  }
  # 新增：按实际网段前缀拼接IP列表，分隔符可根据模板需求替换为\n（换行）、空格等
  controller_ip_str = join(",", [for ctrl in values(local.controllers) : "192.168.1.${ctrl.vm_ip}"])
}

修改template_file配置，传入处理后的字符串：

data "template_file" "lb_userdata" {
  template = file("${path.module}/cloud-init/lb-cloud-config.yaml")
  vars = {
    network_cidr  = var.network_cidr
    controller_ip = local.controller_ip_str
    ip_address    = var.loadbalancer_ip
  }
}

场景2：模板需要主机名+IP的结构化映射（如/etc/hosts配置） #

使用yamlencode()或jsonencode()将复合结构直接序列化为字符串传入，模板渲染时会直接输出标准格式的配置内容：

data "template_file" "lb_userdata" {
  template = file("${path.module}/cloud-init/lb-cloud-config.yaml")
  vars = {
    network_cidr     = var.network_cidr
    controller_ip    = yamlencode(local.controllers)
    ip_address       = var.loadbalancer_ip
  }
}

如果使用templatefile()函数，可直接省略data块定义，在引用用户数据的位置直接渲染：

resource "aws_instance" "lb" {
  # 其他实例配置省略
  user_data = templatefile("${path.module}/cloud-init/lb-cloud-config.yaml", {
    network_cidr  = var.network_cidr
    controller_ip = local.controller_ip_str
    ip_address    = var.loadbalancer_ip
  })
}

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