Terraform部署AWS多AZ NAT网关报count引用错误解决方案

尝试在AWS 3个可用区各部署1个子网，为公有子网aws_subnet.public_subnet资源块设置count = length(var.azs)，实现每个可用区部署1个公有子网，初始配置运行正常，公有子网配置如下：

resource "aws_subnet" "public_subnet" {
  count                   = length(var.azs)
  vpc_id                  = aws_vpc.vpc.id
  cidr_block              = var.public_cidrs[count.index]
  availability_zone       = var.azs[count.index]
  map_public_ip_on_launch = true

  tags = {
    Name = "${var.name}-public-subnet"
  }
}

后续尝试为每个公有子网对应部署1个NAT网关，初始编写的NAT网关配置如下：

resource "aws_nat_gateway" "nat_gateway" {
  allocation_id = aws_eip.nat_eip.id
  subnet_id     = aws_subnet.public_subnet[count.index].id

  tags = {
    Name = "${var.name}-NAT-gateway"
  }
}

执行配置时抛出如下错误：

│ Error: Reference to "count" in non-counted context
│
│   on main.tf line 48, in resource "aws_nat_gateway" "nat_gateway":
│   48:   subnet_id     = aws_subnet.public_subnet[count.index].id
│
│ The "count" object can only be used in "module", "resource", and "data" blocks, and only when the "count"       
│ argument is set.

核心认知误区：NAT网关资源本身完全支持count参数。count是Terraform提供的通用元参数，对所有resource、data、module类型块生效，和具体云资源类型无关，报错的根本原因是NAT网关资源块未声明count参数，而非资源不支持该参数。

要实现每个公有子网对应部署1个NAT网关，需要同时满足两个前提：

• 每个NAT网关必须绑定独立的弹性公网IP（EIP），不可多个NAT网关共用同一个EIP，因此EIP资源也需要通过count批量创建
• NAT网关资源块声明count参数，和公有子网的count逻辑保持一致，保证资源索引一一对应

正确配置代码如下：

# 批量为每个NAT网关创建独立VPC类型弹性公网IP
resource "aws_eip" "nat_eip" {
  count  = length(var.azs)
  domain = "vpc"

  tags = {
    Name = "${var.name}-nat-eip-${count.index}"
  }
}

# 每个公有子网对应部署1个NAT网关
resource "aws_nat_gateway" "nat_gateway" {
  count         = length(var.azs)
  allocation_id = aws_eip.nat_eip[count.index].id
  subnet_id     = aws_subnet.public_subnet[count.index].id

  tags = {
    Name = "${var.name}-NAT-gateway-${var.azs[count.index]}"
  }
}

配置说明：

• 所有批量创建的资源统一使用length(var.azs)作为count值，和可用区数量强绑定，后续调整可用区数量时无需逐块修改资源配置
• EIP资源设置domain = "vpc"，确保创建的是VPC类型EIP，可正常绑定VPC内的NAT网关
• 资源标签增加可用区标识，后续运维排查时可快速定位资源所属可用区

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