使用Terraform创建Azure Functions消费计划时apply提示storage_account参数报错

• 报错的本质是本地加载的azurerm provider版本，和你在配置里声明的版本不匹配。azurerm_function_app资源的参数规则由本地加载的provider schema决定：
  • 当provider版本为2.51.0（你在配置里声明的版本）时，资源根级原生支持storage_account_name、storage_account_access_key两个参数，用于关联函数应用的后端存储
  • 当provider版本为3.0及以上时，azurerm提供方对azurerm_function_app做了破坏性更新：直接移除了资源根级的这两个存储参数，改为通过嵌套块定义存储关联。这时候如果在根级写这两个参数，apply阶段就会触发“参数不被预期”的报错。
• terraform validate能通过的原因是本地存在provider缓存索引不一致：校验阶段读取了残留的2.x版本provider schema，没有识别到参数不匹配；而apply阶段加载了高版本的provider schema，才触发参数校验失败。
• 版本错配的常见诱因是本地残留了旧的.terraform缓存目录、以及历史生成的.terraform.lock.hcl锁文件，调整版本声明后没有重新执行初始化流程，导致实际加载的provider没有匹配你声明的版本约束。

• 步骤1：严格对齐声明的2.51.0版本provider
  • 依次执行清理操作：
    • 删除项目目录下的.terraform缓存文件夹
    • 删除项目目录下的.terraform.lock.hcl锁文件
    • 重新运行terraform init，强制按照required_providers块的版本约束拉取2.51.0版本的azurerm provider
  • 初始化完成后，运行terraform providers命令确认实际加载的azurerm版本为2.51.0，再重新执行apply，原有根级存储参数即可被正常识别，报错消除。
• 步骤2：升级适配新版provider（推荐方案）
  2.51.0为2021年发布的老旧版本，存在已知安全漏洞和功能缺失，建议升级到3.0+的长期支持版本，按照新版资源schema调整配置：
  • 移除资源根级的storage_account_name、storage_account_access_key两个参数，替换为新版要求的storage_account嵌套块，配置示例：

    resource "azurerm_function_app" "example" {
      name                       = "test-azure-functions"
      location                   = azurerm_resource_group.example.location
      resource_group_name        = azurerm_resource_group.example.name
      app_service_plan_id        = azurerm_service_plan.example.id
    
      storage_account {
        name       = azurerm_storage_account.example.name
        access_key = azurerm_storage_account.example.primary_access_key
        type       = "AzureWebJobsStorage"
      }
    }
    

  • 同步替换已废弃的azurerm_app_service_plan资源为新版的azurerm_service_plan资源，调整弹性消耗计划的sku参数配置，确保和最新官方文档的示例对齐。
• 步骤3：额外校验项
  确认存储账号名称符合Azure命名规则：全局唯一、小写字母与数字组合、长度3-24位、无特殊字符，避免参数校验通过但资源创建失败的问题。

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