Terraform中map对象无法使用变量的原因及解决方法

核心问题拆解 #

你遇到的报错主要来自三个点：

1. Terraform语法硬限制：变量的default字段只能用静态值，绝对不能引用其他变量（var.xxx）或本地值（local.xxx）。
2. 类型结构不匹配：变量ec2_details的类型定义里写的是ec2_ebs_volumes，但默认值里误用了ec2_ebs_volume_size；而且默认值多套了一层ec2_details外层键，和map(object(...))的类型要求不符。
3. 拼写错误：locals.tf里的insance_type少了字母t，正确写法是instance_type。

具体错误对应 #

• Variables may not be used here：就是因为你在变量ec2_details的默认值里用了local.amis和local.type，违反了静态默认值的规则。
• Invalid default value for variable：默认值的结构和变量类型定义不匹配——外层多了冗余的ec2_details键，且内部属性名和类型定义不一致。

修复步骤 #

1. 调整变量与本地值的职责 #

把需要复用其他变量的逻辑移到local中，变量只负责定义类型（如果不需要外部传入配置，甚至可以直接删除ec2_details变量，完全用local替代）。

2. 修正结构与拼写 #

• 修复locals.tf里的拼写错误
• 让ec2_details的结构严格匹配类型定义

3. 完整修正代码 #

修正后的variables.tf

variable "type" {
    type        = string
    description = "Instance Type"
    default     = "t2.micro"
}

variable "name_tag" {
    type        = string
    description = "Name"
    default     = "VM"
}

variable "env" {
    type        = string
    description = "Environment of EC2"
    default     = "dev"
}

variable "number_of_instances" {
    type        = number
    description = "Instances"
    default     = 1
}

variable "ami" {
    type        = string
    description = "AMI ID"
    default     = "ami-0a3c3a20c09d6f377"
}

variable "ami_key" {
    type        = string
    description = "Key Pair"
    default     = "key"
}

variable "aws_access_key_id" {}

variable "aws_secret_access_key" {}

# 若不需要外部传入ec2_details配置，可直接删除这个变量
variable "ec2_details" {
    type = map(
        object(
            {
                ami_id            = string
                instance_type     = string
                ec2_ebs_volumes = map(
                    object(
                        {
                            size = number
                        }
                    )
                )
            }
        )
    )
    # 静态默认值或留空，禁止引用变量/local
    default = {}
}

# 补充原来缺失的aws_region变量
variable "aws_region" {
    type        = string
    description = "AWS Region"
    default     = "us-east-1"
}

修正后的locals.tf

locals {
  amis = var.ami
  instance_type = var.type # 修正拼写错误

  # 将原变量默认值的逻辑移到此处，支持引用其他变量/local
  ec2_details = {
    ec2_1 = {
      ami_id            = local.amis
      instance_type     = local.instance_type
      ec2_ebs_volumes = { # 修正属性名，与类型定义一致
        home = {
          size = 10
        }
        log = {
          size = 20
        }
      }
    }
    ec2_2 = {
      ami_id            = local.amis
      instance_type     = local.instance_type
      ec2_ebs_volumes = {
        home = {
          size = 10
        }
        log = {
          size = 20
        }
      }
    }
  }
}

修正后的main.tf（基于local.ec2_details创建实例）

provider "aws" {
    access_key  = var.aws_access_key_id
    secret_key  = var.aws_secret_access_key
    region      = var.aws_region
}

# 遍历local.ec2_details批量创建EC2实例
resource "aws_instance" "aws_vm" {
  for_each = local.ec2_details
  ami             = each.value.ami_id
  instance_type   = each.value.instance_type
  key_name        = var.ami_key

  tags = {
    ec2_dev_name = "${var.name_tag}.${var.env}.${each.key}"
  }

  # 动态挂载EBS卷
  dynamic "ebs_block_device" {
    for_each = each.value.ec2_ebs_volumes
    content {
      device_name = "/dev/xvd${ebs_block_device.key}" # 设备名按需调整
      volume_size = ebs_block_device.value.size
      volume_type = "gp2"
    }
  }
}

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