ARM模板传递Null参数值报错：子网不符合CIDR格式规范

DevOps 小满

2026-7-30

ARM模板子网部署问题修复

错误原因分析

你的模板存在两个核心问题：

地址前缀赋值错误：addressPrefix字段里用了[not(empty(parameters('SubnetAddressPrefix01')))]，这会返回true或false布尔值，而Azure要求子网地址前缀必须是CIDR格式字符串，直接触发格式错误提示。
部署条件不匹配需求：当前condition仅判断环境是否为d01，未关联SubnetAddressPrefix01参数是否为空，无法实现“参数为空则跳过部署”的逻辑。

修正后的模板代码

{
    "type": "Microsoft.Network/virtualNetworks/subnets",
    // 结合环境判断+参数非空判断，满足双条件才部署
    "condition": "[and(not(equals(parameters('environmentAbbreviation'), 'd01')), not(empty(parameters('SubnetAddressPrefix01'))))]",    
    "apiVersion": "2020-05-01",
    "name": "[concat(variables('vnetResourceName'), '/', variables('SubnetName'))]",
    "dependsOn": [
        "[resourceId('Microsoft.Network/virtualNetworks', variables('vnetResourceName'))]"
    ],
    "properties": {
        // 直接传入参数值，确保是合法CIDR格式
        "addressPrefix": "[parameters('SubnetAddressPrefix01')]",
        "networkSecurityGroup": {
          "id": "[resourceId('Microsoft.Network/networkSecurityGroups', variables('networkSecurityGroup1'))]"
        },
        "privateEndpointNetworkPolicies": "Enabled",
        "privateLinkServiceNetworkPolicies": "Enabled"
    }
}

额外配置说明

确保SubnetAddressPrefix01参数类型为string且允许空值：

"parameters": {
    "SubnetAddressPrefix01": {
        "type": "string",
        "defaultValue": "",
        "metadata": {
            "description": "子网CIDR前缀，为空则跳过子网部署"
        }
    }
}