如何在仅单节点启动时连接Gossip Snitch的Cassandra三节点集群？

问题根源 #

你遇到的问题核心在于两点：

1. 系统表副本与一致性不匹配：启用PasswordAuthenticator和CassandraAuthorizer后，认证授权依赖system_auth等系统表。默认情况下这些表的副本因子（RF）为3，读取一致性默认是QUORUM，需要至少2个副本可用才能读取数据，单节点启动时无法满足要求，导致认证失败。
2. 集群启动一致性检查：Cassandra默认要求启动时能找到足够节点达成Gossip一致性，单节点启动时会卡在初始化阶段，无法正常提供服务。

具体解决步骤 #

1. 调整系统表复制策略（集群正常运行时操作） #

确保集群至少2个节点在线，连接cqlsh执行以下命令，将关键系统表的副本因子设置为3（每个节点都拥有完整副本）：

-- 更新system_auth（用户/权限数据）的复制策略
ALTER KEYSPACE system_auth WITH REPLICATION = {'class': 'NetworkTopologyStrategy', 'datacenter1': 3};

-- 更新system_schema（表结构元数据）的复制策略
ALTER KEYSPACE system_schema WITH REPLICATION = {'class': 'NetworkTopologyStrategy', 'datacenter1': 3};

-- 更新system_distributed（分布式任务数据）的复制策略
ALTER KEYSPACE system_distributed WITH REPLICATION = {'class': 'NetworkTopologyStrategy', 'datacenter1': 3};

执行完后，在每个节点上运行修复命令同步副本：

nodetool repair system_auth
nodetool repair system_schema
nodetool repair system_distributed

2. 单节点启动时添加JVM参数 #

启动单个节点时，添加-Dcassandra.allow_single_node=true参数绕过集群一致性检查：

cassandra -Dcassandra.allow_single_node=true

若要永久生效，编辑cassandra-env.sh文件，将参数加入JVM_OPTS：

JVM_OPTS="$JVM_OPTS -Dcassandra.allow_single_node=true"

3. 指定一致性连接cqlsh #

连接单节点时，显式设置读取一致性为LOCAL_ONE（仅需本地节点的一个副本可用）：

cqlsh <节点IP> -u admin1 -p admin1password --consistency LOCAL_ONE

额外注意事项 #

• 单节点运行属于降级状态，仅适合应急场景，尽快恢复其他节点回归正常集群模式
• 若启动后节点状态为Joining，执行nodetool bootstrap resume完成初始化
• 生产环境避免长期单节点运行，这会丧失Cassandra的高可用和分布式特性

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