使用Terraform部署Azure Data Lake Gen2存储账户时遇404 NotFound错误

问题场景 #

使用Terraform在Azure部署启用服务端点的Data Lake Gen2存储账户时，遇到404 Not Found错误，提示目标存储账户不存在。

Terraform配置代码

resource "random_integer" "random_suffix1" {
  min = 10000
  max = 99999
}

resource "azurerm_storage_account" "dev_storage" {
  name                     = "inddatalakedev${random_integer.random_suffix1.result}"
  resource_group_name      = azurerm_resource_group.rg_analytics_dev_central_india.name
  location                 = azurerm_resource_group.rg_analytics_dev_central_india.location
  account_tier             = "Standard"
  account_replication_type = "LRS"
  is_hns_enabled           = true
  public_network_access_enabled = false  
  infrastructure_encryption_enabled = true
  account_kind = "StorageV2"


  network_rules {
    default_action             = "Deny"
    virtual_network_subnet_ids = [
      azurerm_subnet.private-dev.id,
      azurerm_subnet.public-dev.id,
      azurerm_subnet.pe-subnet.id
    ]
  }
  depends_on = [azurerm_subnet.pe-subnet]
}


resource "azurerm_storage_account" "prod_storage" {
  name                     = "inddatalakeprod${random_integer.random_suffix1.result}"
  resource_group_name      = azurerm_resource_group.rg_analytics_prod_central_india.name
  location                 = azurerm_resource_group.rg_analytics_prod_central_india.location
  account_tier             = "Standard"
  account_replication_type = "LRS"
  is_hns_enabled           = true
  public_network_access_enabled = false  
  infrastructure_encryption_enabled = true
  account_kind = "StorageV2"


  network_rules {
    default_action             = "Deny"
    virtual_network_subnet_ids = [
      azurerm_subnet.public.id,
      azurerm_subnet.private.id,
      azurerm_subnet.private-dev.id,
      azurerm_subnet.public-dev.id,
      azurerm_subnet.pe-subnet.id
    ]
  }
  depends_on = [azurerm_storage_account.dev_storage]
}

报错信息

错误：检索存储账户（订阅："XXXXXXXXXXXXX" │ 资源组名称："RG-Analytics-Dev-CentralIndia" │ 存储账户名称："inddatalakedev27620"）：意外状态码404（404 Not Found），错误信息：StorageAccountNotFound: 未找到存储账户inddatalakedev27620。│ │ 涉及资源：azurerm_storage_account.dev_storage，│ 位于storage.tf第11行，resource "azurerm_storage_account" "dev_storage"块中：│ 11: resource "azurerm_storage_account" "dev_storage" {

排查与解决步骤 #

1. 验证存储账户名称合法性与唯一性

Azure存储账户名称要求：

• 长度3-24字符，仅含小写字母和数字
• 全局唯一

手动在Azure Portal搜索inddatalakedev27620，确认是否已被其他租户占用。若存在重复，建议改用更随机的后缀生成方式，比如：

resource "random_string" "storage_suffix" {
  length  = 5
  special = false
  upper   = false
}

2. 确认资源组关联正确性

检查azurerm_resource_group.rg_analytics_dev_central_india是否存在，且Terraform能正确读取其名称。可添加输出验证：

output "dev_rg_name" {
  value = azurerm_resource_group.rg_analytics_dev_central_india.name
}

执行terraform apply后查看输出，确认资源组名称与报错中的RG-Analytics-Dev-CentralIndia完全一致。

3. 解决网络规则导致的访问限制

你设置了public_network_access_enabled = false且默认拒绝公网访问，若Terraform运行环境不在允许的子网内，会导致部署后无法检索存储账户（Terraform需要调用Azure API访问该资源）。

可选解决方案：

• 临时开启public_network_access_enabled = true，完成部署后再关闭；
• 将Terraform运行所在的公网IP添加到存储账户白名单：

network_rules {
  default_action             = "Deny"
  virtual_network_subnet_ids = [
    azurerm_subnet.private-dev.id,
    azurerm_subnet.public-dev.id,
    azurerm_subnet.pe-subnet.id
  ]
  ip_rules = ["你的Terraform运行IP/32"]
}

4. 修复Terraform状态文件一致性

若之前部署失败导致状态文件残留错误记录，执行以下操作：

# 删除错误的状态条目
terraform state rm azurerm_storage_account.dev_storage
# 同步状态
terraform refresh

之后重新执行terraform apply。

5. 更新Azure Provider版本

旧版本azurerm provider可能存在API兼容性问题，在versions.tf中指定稳定版本并升级：

terraform {
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = ">= 3.0.0"
    }
  }
}

执行terraform init -upgrade完成provider升级。

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