Terraform创建Azure虚拟网络报错：对象无subnetName属性

常见问题原因及排查步骤 #

1. 本地JSON配置结构不匹配 #

Terraform报错的核心是代码中引用的subnetName属性在你定义的本地块JSON对象中不存在，大概率是JSON字段层级或命名问题：

• 检查JSON文件里的子网字段是否嵌套正确，比如是否放在subnets数组下，而非VNet根对象直接包含；
• 确认JSON里的子网名称字段实际命名，比如是否是name而非subnetName（Azure子网的标准命名字段为name）。

示例错误JSON结构：

{
  "vnet_name": "my-vnet",
  "address_space": ["10.0.0.0/16"],
  "subnetName": "app-subnet"  // 错误：子网字段未嵌套，且命名不符合常规结构
}

正确JSON结构参考：

{
  "vnets": [
    {
      "name": "my-vnet",
      "address_space": ["10.0.0.0/16"],
      "subnets": [
        {
          "name": "app-subnet",  // 子网名称字段
          "address_prefix": "10.0.1.0/24"
        }
      ]
    }
  ]
}

2. For_each 遍历层级错误 #

如果你的本地块是包含多个VNet的数组，直接遍历根对象会导致无法正确访问子网属性。需要调整遍历层级，确保能定位到子网所在的数组：

错误遍历示例：

resource "azurerm_virtual_network" "example" {
  for_each = local.vnet_config  // 错误：直接遍历根对象，无法访问子网属性
  name                = each.value.name
  address_space       = each.value.address_space
  subnet {
    name           = each.value.subnetName  // 找不到该属性
    address_prefix = each.value.subnetPrefix
  }
}

3. 字段名称拼写/大小写不匹配 #

JSON是大小写敏感格式，若JSON里字段是subnetname（小写n），但Terraform代码里写subnetName（大写N），也会触发属性不存在错误。

修正后的代码示例 #

以下是匹配正确JSON结构的Terraform配置：

locals {
  vnet_config = jsondecode(file("vnet_config.json"))
}

resource "azurerm_virtual_network" "example" {
  # 遍历VNet数组，以VNet名称作为键
  for_each = { for vnet in local.vnet_config.vnets : vnet.name => vnet }

  name                = each.value.name
  address_space       = each.value.address_space
  location            = azurerm_resource_group.example.location
  resource_group_name = azurerm_resource_group.example.name

  # 动态生成子网，遍历当前VNet下的subnets数组
  dynamic "subnet" {
    for_each = each.value.subnets
    content {
      name           = subnet.value.name  // 对应JSON里的子网名称字段
      address_prefix = subnet.value.address_prefix
    }
  }
}

快速验证方法 #

在代码中添加输出块，打印本地块的完整结构，确认属性路径是否正确：

output "vnet_config_details" {
  value = local.vnet_config
}

执行terraform plan后，查看输出的结构，确认subnetName（或实际子网名称字段）的层级和拼写。

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