Terraform拆分VPC与EC2模块：子网输出传递及plan报错解决

核心错误定位 #

• 传参键名不匹配：EC2模块内定义的必填变量为tnt_public_subnets_cidr，但根模块调用时使用的传参键是subnet_id，Terraform无法识别该参数对应已定义的模块变量，直接触发“缺少必填参数tnt_public_subnets_cidr”的报错。
• 取值逻辑错误：VPC模块输出的tnt_public_subnets_cidr本身是子网ID组成的列表，不存在.id属性，额外追加.id的访问方式无法取到有效值。
• 参数类型不匹配：aws_instance资源的subnet_id为单字符串类型参数，无法直接接收子网ID列表，必须根据业务场景从列表中取出对应单值绑定。

全链路正确配置示例 #

VPC模块输出配置 #

基于你使用count创建多可用区公共子网的场景，确保输出为正确的子网ID列表：

# 模块路径：./modules/vpc/outputs.tf
resource "aws_subnet" "public" {
  count             = length(var.availability_zones)
  vpc_id            = aws_vpc.main.id
  cidr_block        = cidrsubnet(aws_vpc.main.cidr_block, 8, count.index)
  availability_zone = var.availability_zones[count.index]
}

output "tnt_public_subnets_cidr" {
  value       = aws_subnet.public[*].id
  description = "跨可用区创建的公共子网ID列表"
}

EC2（webserver）模块配置 #

首先定义和传参键完全一致的变量，再匹配aws_instance的参数类型要求：

# 模块路径：./modules/webserver/variables.tf
variable "tnt_public_subnets_cidr" {
  type        = list(string)
  description = "从VPC模块传入的公共子网ID列表"
}

# 模块路径：./modules/webserver/main.tf
# 单台EC2场景：绑定列表中第一个子网
resource "aws_instance" "web" {
  ami           = "ami-xxxxxxx"
  instance_type = "t3.micro"
  subnet_id     = var.tnt_public_subnets_cidr[0]
}

# 多EC2跨可用区部署场景：按count索引匹配对应子网
# resource "aws_instance" "web" {
#   count         = length(var.tnt_public_subnets_cidr)
#   ami           = "ami-xxxxxxx"
#   instance_type = "t3.micro"
#   subnet_id     = var.tnt_public_subnets_cidr[count.index]
# }

根模块调用配置 #

传参键必须与EC2模块定义的变量名完全对齐，直接引用VPC模块的输出值：

# 根路径下main.tf
module "vpc" {
  source = "./modules/vpc"
  # 填入VPC模块所需的其他入参（如VPC CIDR、可用区列表等）
}

module "webserver" {
  source = "./modules/webserver"
  # 传参键严格匹配EC2模块的变量名，直接引用VPC模块输出
  tnt_public_subnets_cidr = module.vpc.tnt_public_subnets_cidr
  # 填入EC2模块所需的其他入参
}

原错误写法对比：subnet_id = module.vpc.tnt_public_subnets_cidr.id
逐点错误拆解：

1. 传参键写为subnet_id，与EC2模块定义的变量名tnt_public_subnets_cidr不匹配，触发必填参数缺失报错
2. 对列表类型的输出值追加.id属性，列表结构无该属性，即使键名匹配也会触发取值类型错误

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