为Azure存储账户Queue子资源创建子模块遇Terraform参数错误

报错原因 #

这个错误说明你在调用storage_queue子模块时，传递了该子模块未定义的name参数，或者参数传递的语法/逻辑存在问题。结合Azure存储队列的Terraform配置场景，核心原因通常是子模块未声明name输入变量，或者调用时参数传递格式错误。

常见错误代码示例 #

1. 根模块的队列变量定义 #

variable "queues" {
  type = list(object({
    name     = string
    metadata = optional(map(string))
  }))
  default = []
}

2. 错误的子模块调用方式 #

module "storage_queue" {
  for_each = { for q in var.queues : q.name => q }
  source   = "./modules/storage_queue"

  name               = each.value.name  # 此处报错：子模块未定义name变量
  storage_account_id = azurerm_storage_account.main.id
}

3. 子模块未正确声明变量 #

./modules/storage_queue/variables.tf缺失变量定义：

# 缺少name变量的声明
variable "storage_account_id" {
  type        = string
  description = "ID of the parent storage account"
}

修正方案 #

步骤1：给子模块添加必要的输入变量 #

在./modules/storage_queue/variables.tf中补充name变量：

variable "name" {
  type        = string
  description = "Name of the Azure Storage Queue"
}

variable "storage_account_id" {
  type        = string
  description = "Resource ID of the parent storage account"
}

步骤2：正确调用子模块 #

根模块中确保传递的参数与子模块定义的变量完全匹配：

module "storage_queue" {
  for_each = { for q in var.queues : q.name => q }
  source   = "./modules/storage_queue"

  name               = each.value.name
  storage_account_id = azurerm_storage_account.main.id
}

步骤3：子模块内部正确使用变量 #

在./modules/storage_queue/main.tf中，用变量配置队列资源（注意Azure队列的命名规则）：

resource "azapi_resource" "queue" {
  type      = "Microsoft.Storage/storageAccounts/queues@2023-01-01"
  name      = var.name  # 相对于父存储账户的队列名称
  parent_id = var.storage_account_id

  # 如果需要配置metadata等属性，可添加对应参数
  body = jsonencode({
    properties = {
      metadata = each.value.metadata
    }
  })
}

额外排查点 #

• 检查子模块变量名是否拼写一致，比如是否误将变量名定义为queue_name却在调用时传name
• 用terraform console验证var.queues的结构，确认each.value确实包含name字段
• 确保Azure存储队列名称符合命名规范（只能包含小写字母、数字和短横线，不能以短横线开头/结尾）

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