Terraform使用templatefile插值列表报错：需字符串类型

问题根源 #

你遇到的错误是因为templatefile函数要求模板中直接插值的变量为字符串类型，但你传入了列表（复杂类型），直接插值会导致类型不匹配，同时生成的内容也不符合YAML语法规范。

两种可行解决方法 #

方法一：用模板循环生成YAML列表（推荐，适合复杂场景） #

通过Terraform模板的循环语法，逐个渲染列表元素，生成符合YAML格式的列表结构。

1. 编写YAML模板文件（例如config.tpl.yaml）：

# 示例配置模板
server_config:
  port: ${server_port}
  allowed_ips:
% for ip in allowed_ips ~%
  - ${ip}
% endfor ~%

这里的% for ... %是Terraform模板的循环语法，~%用于移除多余换行符，保证生成的YAML格式整洁。

2. Terraform代码中调用模板：

variable "server_port" {
  type        = number
  default     = 8080
}

variable "allowed_ips" {
  type        = list(string)
  default     = ["192.168.1.1", "10.0.0.0/24"]
}

locals {
  # 渲染模板得到YAML字符串
  rendered_yaml = templatefile("${path.module}/config.tpl.yaml", {
    server_port  = var.server_port
    allowed_ips  = var.allowed_ips
  })
  # 解析YAML并转成JSON输出
  config_json   = jsonencode(yamldecode(local.rendered_yaml))
}

output "config_json" {
  value = local.config_json
}

方法二：用join+formatlist生成内联YAML列表（适合简单场景） #

如果需要生成内联格式的YAML列表，可以通过formatlist给每个元素添加引号，再用join拼接成逗号分隔的字符串，直接插入模板。

1. YAML模板文件：

server_config:
  port: ${server_port}
  allowed_ips: [${join(", ", formatlist("%q", allowed_ips))}]

formatlist("%q", allowed_ips)会给每个IP地址添加双引号，join(", ", ...)将列表元素拼接成"192.168.1.1", "10.0.0.0/24"的格式，插入后符合YAML内联列表语法。

2. Terraform调用代码和方法一一致，只需替换模板内容即可。

关键注意事项 #

• 避免直接在模板中插值列表变量（例如${allowed_ips}），这种方式会生成Terraform默认的列表字符串表示（如[192.168.1.1 10.0.0.0/24]），既不符合YAML语法，也会触发类型错误。
• 模板循环语法中，注意缩进和%标记的使用，确保生成的YAML结构正确，否则yamldecode会解析失败。

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