Terraform创建AWS路由表时遇属性类型错误的排查与解决

报错信息 #

Error: Incorrect attribute value type

on main.tf.json line 110, in resource.aws_route_table.public_rt:
110: "route": [
111: {
112: "cidr_block": "0.0.0.0/0",
113: "gateway_id": "${aws_internet_gateway.main_igw.id}"
114: }
115: ],
Inappropriate value for attribute "route": element 0: attributes "carrier_gateway_id", "core_network_arn", "destination_prefix_list_id", "egress_only_gateway_id", "ipv6_cidr_block", "local_gateway_id", "nat_gateway_id", "network_interface_id", "transit_gateway_id", "vpc_endpoint_id", and "vpc_peering_connection_id" are required.

背景 #

我正尝试为AWS中的VPC配置关联Internet Gateway的路由表，使用的Terraform JSON配置如下：

"aws_route_table": {
   "public_rt": {
       "vpc_id": "${var.vpc_id}",
       "route": [
           {
               "cidr_block": "0.0.0.0/0",
               "gateway_id": "${aws_internet_gateway.main_igw.id}"
           }
       ],
       "tags": {
           "Name": "Public Route Table"
       },
       "depends_on": [
           "aws_internet_gateway.main_igw"
       ]
   }
}

我已经在同一配置中单独定义了Internet Gateway，执行terraform apply时触发上述错误。

疑问 #

这个错误的原因是什么？要如何修复此AWS路由配置？是需要为路由添加额外属性，还是与Terraform的AWS Provider版本有关？

这个错误的核心原因是Terraform AWS Provider版本与配置语法不匹配：

1. 版本差异说明：

   • 若使用AWS Provider v3.x及更早版本，aws_route_table资源中的route字段是嵌套对象列表，只需提供必要的路由属性（如cidr_block和gateway_id）即可。
   • 若升级到AWS Provider v4.0+，route字段的语法发生了根本性变化——不再允许在aws_route_table中嵌套定义路由，必须使用单独的aws_route资源来创建路由条目。

2. 修复方案：
   根据你使用的Provider版本，有两种修复方式：

   • 方式一：降级AWS Provider到v3.x
     在配置中指定Provider版本，可继续使用当前的嵌套路由写法：

     provider "aws" {
       version = "~> 3.0"
       region  = "你的AWS区域"
     }
     

   • 方式二：升级配置适配v4.x+ Provider
     移除aws_route_table中的route字段，改用单独的aws_route资源定义路由：

     // 保留原路由表定义，移除route字段
     "aws_route_table": {
        "public_rt": {
            "vpc_id": "${var.vpc_id}",
            "tags": {
                "Name": "Public Route Table"
            },
            "depends_on": [
                "aws_internet_gateway.main_igw"
            ]
        }
     },
     // 添加单独的路由资源
     "aws_route": {
        "public_default_route": {
            "route_table_id": "${aws_route_table.public_rt.id}",
            "destination_cidr_block": "0.0.0.0/0",
            "gateway_id": "${aws_internet_gateway.main_igw.id}"
        }
     }
     

     注意：v4.x版本中路由目标的字段名从cidr_block改为了destination_cidr_block，这也是语法变化的一部分。

3. 额外提示：
   建议优先选择方式二，因为v3.x版本的Provider已停止维护，升级到最新版本能获得更好的兼容性和新特性支持。

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