Terraform手动执行init时提示找不到azurerm后端存储容器怎么办

调试步骤 #

• 先清理本地Terraform缓存
  本地之前如果执行过terraform init绑定过其他后端，会在.terraform目录残留旧的后端配置，导致触发状态迁移逻辑时读取错误配置。先执行以下命令清理后重试：

  rm -rf .terraform .terraform.lock.hcl
  

• 校验后端配置参数正确性
  • 确认手动传入的storage_account_name、access_key和管道中使用的完全一致，复制时不要带入多余空格、换行符，Azure存储账户名、容器名均为全小写规则，注意大小写拼写错误
  • 检查key参数末尾的:us是否为误拼接：如果管道中使用了Terraform工作区，工作区参数应该通过-workspace=us单独传入，而非直接拼在状态文件路径后，错误的路径解析可能引发资源查找异常
• 独立验证存储账户访问权限
  使用Azure CLI直接验证你使用的密钥是否有权限访问对应容器，排除参数错误问题：

  az storage container exists --name auto-api-tfstate --account-name <替换为你的存储账户名> --account-key <替换为你的access_key>
  

  如果返回false，说明你使用的存储账户名、密钥有误；如果返回true则说明凭证正常，问题出在Terraform运行环境侧
• 排查环境差异
  • 确认本地Terraform版本和ADO管道中使用的版本完全一致，跨大版本的azurerm后端实现存在差异可能引发兼容性问题
  • 检查本地是否配置了ARM_ENVIRONMENT、ARM_ENDPOINT等Azure相关环境变量，和管道中的环境变量对比，避免本地误配置为 Azure 中国区、政府区等其他云环境导致访问 endpoint 错误
  • 排查本地网络是否有防火墙、代理规则拦截了Azure存储域名的访问，可尝试切换公共网络重试

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