Terraform执行plan时出现enable_classiclink相关内部库错误排查

问题描述 #

基于HashiCorp示例修改.tf文件，尝试用Terraform在AWS创建多可用区（multi-az）RDS，执行terraform plan时，Terraform内部库抛出错误，但未提示自身.tf文件存在问题。

补充说明 #

将HashiCorp仓库克隆到新目录时无报错，但仅复制4个.tf文件到其他目录，执行terraform init和terraform plan时会再次出现错误，看起来像是Terraform需要.git目录或其他同目录文件，这一现象十分奇怪。

报错信息 #

$ terraform plan
╷
│ Warning: Argument is deprecated
│ 
│   with module.vpc.aws_eip.nat,
│   on .terraform/modules/vpc/main.tf line 970, in resource "aws_eip" "nat":
│  970:   vpc = true
│ 
│ use domain attribute instead
╵
╷
│ Error: Unsupported argument
│ 
│   on .terraform/modules/vpc/main.tf line 36, in resource "aws_vpc" "this":
│   36:   enable_classiclink               = var.enable_classiclink
│ 
│ An argument named "enable_classiclink" is not expected here.
╵
╷
│ Error: Unsupported argument
│ 
│   on .terraform/modules/vpc/main.tf line 37, in resource "aws_vpc" "this":
│   37:   enable_classiclink_dns_support   = var.enable_classiclink_dns_support
│ 
│ An argument named "enable_classiclink_dns_support" is not expected here.
╵
╷
│ Error: Unsupported argument
│ 
│   on .terraform/modules/vpc/main.tf line 1194, in resource "aws_default_vpc" "this":
│ 1194:   enable_classiclink   = var.default_vpc_enable_classiclink
│ 
│ An argument named "enable_classiclink" is not expected here.
╵

我的.tf文件内容 #

provider "aws" {
  region = var.region
}

data "aws_availability_zones" "available" {}

module "vpc" {
  source = "terraform-aws-modules/vpc/aws"
  version = "2.77.0"
  name = "vpc.rds.multi-az"
  cidr = "10.0.0.0/16"
  azs = data.aws_availability_zones.available.names
  public_subnets = ["10.0.4.0/24", "10.0.5.0/24", "10.0.6.0/24"]
  enable_dns_hostnames = true
  enable_dns_support = true
}

resource "aws_db_subnet_group" "rds_multi_az" {
  name = "rds.multi-az"
  subnet_ids = module.vpc.public_subnets
}

resource "aws_security_group" "rds_multi_az" {
  name = "rds.multi-az"
  vpc_id = module.vpc.vpc_id

  ingress {
    from_port = 5432
    to_port = 5432
    protocol = "tcp"
    cidr_blocks = ["0.0.0.0/0"]
  }

  egress {
    from_port = 5432
    to_port = 5432
    protocol = "tcp"
    cidr_blocks = ["0.0.0.0/0"]
  }
}

resource "aws_db_parameter_group" "rds_multi_az" {
  name = "rds.multi-az"
  family = "postgres14"
  parameter {
    name  = "log_connections"
    value = "1"
  }
}

resource "aws_db_instance" "rds_multi_az" {
  identifier = "rds.multi-az"
  instance_class = "db.t3.micro"
  allocated_storage = 5
  engine = "postgres"
  engine_version = "14.7"
  username = "multiaz"
  password = var.db_password
  db_subnet_group_name = aws_db_subnet_group.rds_multi_az.name
  vpc_security_group_ids = [aws_security_group]
  parameter_group_name = aws_db_parameter_group.rds_multi_az.name
  publicly_accessible = true
  skip_final_snapshot = true
  multi_az = true
}

原因分析与解决方案 #

核心原因 #

错误并非Terraform需要.git目录，而是AWS Provider版本与VPC模块版本不兼容：

• 你使用的VPC模块版本2.77.0中包含enable_classiclink等参数，但这些参数对应的AWS ClassicLink功能已被废弃，较新版本的AWS Provider已移除对这些参数的支持。
• 克隆原仓库时，仓库内的.terraform.lock.hcl锁定文件固定了兼容该VPC模块的旧版AWS Provider；仅复制.tf文件到新目录时，无锁定文件约束，terraform init会自动拉取最新的AWS Provider版本，导致参数不匹配报错。

解决方案 #

有两种可行的修复方式：

1. 升级VPC模块到兼容新版AWS Provider的版本
   修改VPC模块的version字段至3.x系列（该系列已移除ClassicLink相关参数），示例：

   module "vpc" {
     source = "terraform-aws-modules/vpc/aws"
     version = "3.2.0" # 或更高兼容版本
     # 其余参数保持不变
   }
   

   注意：升级模块后可能需调整部分参数（如输出变量名称变化），需参考对应版本的模块文档修改配置。

2. 固定AWS Provider的旧版本
   在provider "aws"块中添加版本约束，指定兼容VPC模块2.77.0的版本（如~> 3.0）：

   provider "aws" {
     region = var.region
     version = "~> 3.0"
   }
   

   执行terraform init后会生成锁定文件，固定Provider版本，避免自动升级导致的不兼容问题。

额外配置修复 #

你的aws_db_instance资源存在一处小错误：vpc_security_group_ids应引用安全组的ID而非资源本身，需修改为：

vpc_security_group_ids = [aws_security_group.rds_multi_az.id]

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