Terraform部署AWS RDS子模块时遇Unsupported argument错误求助

核心问题定位 #

错误提示的是aws_db_instance资源不接受db_name参数，和变量的定义、模块间传递无关——你的变量声明和跨模块传递逻辑都是正确的，问题出在RDS资源的参数使用规则上。

常见原因及解决方法 #

• 使用了不支持db_name的数据库引擎
  如果你的var.db_engine是Aurora系列（比如aurora-mysql、aurora-postgresql），这类数据库的名称是在aws_rds_cluster资源中通过database_name字段定义的，而作为集群节点的aws_db_instance不能设置db_name。直接删除rds.tf中db_name = var.db_name这一行，把数据库名配置到集群资源里即可。

• AWS Provider版本兼容性问题
  你当前使用的Terraform版本是1.4.2，检查根目录下的versions.tf/provider.tf中AWS Provider的版本。部分旧版本的AWS Provider对特定引擎的db_name参数有限制，建议升级到稳定版本，示例配置：

  terraform {
    required_providers {
      aws = {
        source  = "hashicorp/aws"
        version = "~> 5.0"
      }
    }
  }
  

  升级后执行terraform init -upgrade更新Provider。

• 当前实例是只读副本
  如果你的aws_db_instance配置了replicate_source_db参数（作为只读副本），db_name参数是不允许设置的，因为副本会继承源数据库的名称。检查rds.tf中是否存在该参数，若有则删除db_name配置。

验证步骤 #

1. 执行terraform console，输入var.db_engine查看实际使用的数据库引擎，确认是否属于不支持db_name的类型。
2. 核对你使用的AWS Provider版本对应文档，确认目标引擎的aws_db_instance资源是否支持db_name参数。

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