Terraform部署Redis集群报错：engine "redis"不支持num_cache_nodes>1

这个错误其实是因为你混淆了AWS ElastiCache中Redis两种部署架构的配置方式，我来给你拆解清楚：

错误根源 #

你当前使用的aws_elasticache_cluster资源，是专门针对Redis的**非集群模式（主从复制，单分片）**设计的。如果想要搭建真正的多分片Redis集群（Cluster Mode Enabled），这个资源并不支持通过num_cache_nodes参数来配置多节点，必须换用另一个Terraform资源。

另外，如果只是想配置主从复制（非集群），理论上num_cache_nodes可以设置为2-6（1主+1到5个只读副本），但如果你同时开启了集群模式的配置，也会触发这个错误。

两种解决方案根据你的需求选： #

1. 我要的是主从复制架构（单分片，非集群）

确保没有启用集群模式，直接调整num_cache_nodes到合法范围（2-6）即可，示例配置：

resource "aws_elasticache_cluster" "redis_replica" {
  cluster_id           = "my-redis-replica"
  engine               = "redis"
  node_type            = "cache.t3.micro"
  num_cache_nodes      = 2 # 1主1从，最多可设为6
  parameter_group_name = "default.redis6.x" # 用非集群的参数组
  engine_version       = "6.x"
  port                 = 6379
}

2. 我要的是多分片Redis集群（Cluster Mode Enabled）

放弃aws_elasticache_cluster，改用aws_elasticache_replication_group资源，并通过cluster_mode块来配置集群节点，示例：

resource "aws_elasticache_replication_group" "redis_cluster" {
  replication_group_id          = "my-redis-cluster"
  engine                        = "redis"
  engine_version                = "6.x"
  node_type                     = "cache.t3.micro"
  parameter_group_name          = "default.redis6.x.cluster.on" # 启用集群的参数组
  automatic_failover_enabled    = true
  multi_az_enabled              = true

  cluster_mode {
    num_node_groups          = 2 # 分片数量
    replicas_per_node_group  = 1 # 每个分片的只读副本数量
  }
}

这里总节点数是 num_node_groups × (1 + replicas_per_node_group)，上面的例子就是2×2=4个节点（2个主分片，每个配1个副本）。

额外注意点 #

• 集群模式必须使用支持集群的参数组，比如default.redis6.x.cluster.on，不能用普通的非集群参数组；
• 如果开启了multi_az_enabled，automatic_failover_enabled也必须设为true。

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