Skip to content

Terraform plan 错误:资源类型未找到

快速摘要

你的 Terraform 配置引用了未知资源类型 —— 提供者不识别它。

为什么发生

  • 资源类型名称拼写错误或提供者中不存在

  • 所需的提供者未在配置中声明或未安装

  • 提供者版本不支持所使用的资源类型

最小示例

✗ 错误代码
resource "aws_s3_buckettt" "my_bucket" { # typo: buckettt instead of bucket
  bucket = "my-bucket"
}
✓ 修复代码
resource "aws_s3_bucket" "my_bucket" { # correct resource type
  bucket = "my-bucket"
}

将资源类型名称更正为 aws_s3_bucket 匹配 AWS 提供者的文档,plan 成功。

如何诊断

  • 运行 terraform plan 查看包含未知资源类型的错误消息

  • 查看提供者文档以获取有效资源类型及其名称

  • 验证提供者在 required_providers 块中声明且版本支持该资源

如何修复

  • 更正资源类型名称以匹配提供者的文档

  • 将所需的提供者添加到配置的 required_providers 块中

  • 升级提供者到支持该资源类型的版本

如何预防

  • 在 CI 中使用 terraform validate 和 Terraform linter 在应用前捕获错误

  • 固定提供者版本并参考匹配的文档

相关资源

相关术语

相关课程

← 返回语言