Terraform嵌套模块间变量传递失败问题排查求助

问题核心分析 #

报错提示component_name参数不被ecs_service_accountcreation模块接受，说明你当前调用的ecs_service_accountcreation模块本身并未在其variables.tf中声明component_name输入变量——哪怕terraform-aws-ecs-service模块定义了这个变量也没用，因为变量传递是层级式的，上层模块只能传递给直接调用的子模块已声明的变量。

分步解决方法 #

1. 检查目标模块的变量声明
   找到ecs_service_accountcreation模块的variables.tf文件（对应.terraform/modules/aws-ecs-app/service-accountcreation.tf关联的模块源路径），确认是否存在如下定义：

   variable "component_name" {
     type        = string
     description = "用于ECS服务名称和负载均衡配置的组件名称"
   }
   

   如果没有，直接添加这段代码。

2. 传递变量到下层依赖模块
   在ecs_service_accountcreation模块的main.tf中，将刚声明的component_name变量传递给它内部调用的terraform-aws-ecs-service模块：

   module "ecs_service" {
     source = "terraform-aws-modules/ecs-service/aws"
     # 保留其他已配置参数
     component_name = var.component_name
   }
   

3. 重新初始化并验证配置
   在根模块目录执行以下命令：

   terraform init -upgrade
   terraform validate
   

   完成后再执行terraform plan确认问题是否解决。

关键注意事项 #

• 模块变量传递是逐层透传的：根模块→ecs-app模块→ecs_service_accountcreation模块→terraform-aws-ecs-service模块，每一层都需要在当前模块声明对应的输入变量，才能继续向下传递。
• 子模块目录validate正常是因为子模块自身配置合法，但上层调用时传入了子模块未声明的参数，所以根目录validate失败。

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