如何将Terraform locals变量转为带字面量大括号的字符串适配ECS任务定义？

问题场景 #

现有Terraform代码尝试把locals中的env_vars映射转换为符合ECS任务定义格式的字符串，硬编码方式可正常运行，但使用循环拼接时出现JSON解析错误。

现有代码 #

locals定义

locals {
  env_vars = {
    STAGE               = var.environment
    ENVIRONMENT         = var.environment
    REGION              = var.region
    AWS_DEFAULT_REGION  = var.region
  }
}

容器定义模板调用

container_definitions = templatefile("${path.module}/task-definitions/ecs-web-app.json", {
    # 硬编码方式可正常运行
    # ENVIRONMENT_VARS = <<EOT
    #                     {"name":"STAGE","value":"${var.environment}"},
    #                     {"name":"ENVIRONMENT","value":"${var.environment}"},
    #                     {"name":"REGION","value":"${var.region}"},
    #                     {"name":"AWS_DEFAULT_REGION","value":"${var.region}"}
    #                   EOT

    # 尝试的动态拼接方式（报错）
    ENVIRONMENT_VARS = join(",", [for key, value in local.env_vars : "{{\"name\":\"${key}\",\"value\":\"${value}}}""])
})

ecs-web-app.json模板

[
    {
        "environment":[
            ${ENVIRONMENT_VARS}
        ]
    }
]

错误信息 #

Error: ECS Task Definition container_definitions is invalid: Error decoding JSON: invalid character '{' looking for the beginning of object key string

错误原因 #

手动拼接JSON字符串时存在两个关键问题：

1. 最后一个大括号未正确转义：原代码里的"${value}}}"格式错误，即使修正转义，手动拼接也容易遗漏细节
2. 手动处理嵌套引号、括号的转义极易破坏JSON语法结构，导致ECS无法正常解析

解决方案 #

放弃手动拼接JSON字符串，改用Terraform内置的jsonencode函数自动处理每个环境变量对象的序列化，再用join拼接成所需格式：

修正后的模板调用代码 #

container_definitions = templatefile("${path.module}/task-definitions/ecs-web-app.json", {
    ENVIRONMENT_VARS = join(",", [for key, value in local.env_vars : jsonencode({ name = key, value = value })])
})

说明 #

• jsonencode({ name = key, value = value })会自动将每个键值对序列化为符合JSON规范的字符串（比如{"name":"STAGE","value":"dev"}），无需手动处理引号、括号的转义
• join(",", ...)将所有序列化后的字符串用逗号分隔，完美匹配ECS环境变量数组的格式
• 这种方式生成的字符串完全符合JSON语法，不会出现解析错误

另外，locals里的变量引用可简化，无需用${}包裹，直接写var.environment即可，Terraform会自动解析。

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