Apache Cassandra replication_factor配置异常问题咨询

你提到用SimpleStrategy、replication_factor=2创建了books3 keyspace，集群包含3个节点（192.168.0.2、192.168.0.3、192.168.0.5），但写入users表时出现异常——这种场景我在日常调试Cassandra集群时碰到过很多次，咱们一步步拆解可能的问题，找到根源：

• 先确认Keyspace配置是否真的生效
  有时候创建Keyspace时可能手滑打错参数（比如把replication_factor写成复数），导致实际配置和预期不符。先在cqlsh里执行这条命令确认：

  DESCRIBE KEYSPACE books3;
  

  正常的配置输出应该包含：

  WITH replication = {'class': 'SimpleStrategy', 'replication_factor': '2'} AND durable_writes = true;
  

  如果配置不对，重新执行正确的修改命令：

  ALTER KEYSPACE books3 WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 2
  };
  

• 检查集群节点状态与连通性
  用nodetool status查看所有节点的状态：

  • 确保3个节点都是UN（Up/Normal）状态，如果有节点显示DN（Down），那RF=2的情况下，当某个分区的两个副本刚好落在Down节点和另一个节点时，写入就会因为无法找到可用副本而失败。
  • 同时检查节点之间的gossip通信是否正常：每个节点的cassandra.yaml里的seed_provider要包含至少一个存活的种子节点，节点之间要能互相ping通，gossip端口（默认7000/7001）和CQL端口（9042）要开放，没有防火墙拦截。

• 排查一致性级别与副本可用性的冲突
  Cassandra的写入一致性级别决定了需要多少个副本确认写入才算成功。如果你用了QUORUM级别（对于RF=2，QUORUM需要2个副本确认），此时只要有一个节点不可用，写入就会超时失败。
  可以先在cqlsh里临时切换到低一致性级别测试：

  CONSISTENCY ONE;
  INSERT INTO users (...) VALUES (...); -- 执行你的写入语句
  

  如果能成功写入，说明问题出在一致性级别和当前副本可用性不匹配上。

• 验证分区的副本放置情况
  你提到副本是按分区器+顺时针环放置的，可以用nodetool查看具体分区的副本节点：

  nodetool getendpoints books3 users <你的分区键值>
  

  比如你的users表用user_id作为分区键，就执行nodetool getendpoints books3 users 123。如果返回的节点数量不足2，说明集群的token环分配有问题，此时可以用nodetool ring查看token范围分布，确认每个节点的token区间是否合理——如果有节点没有分配到token，或者token分布异常，可能需要重新平衡集群。

• 查看日志定位具体错误
  以上步骤都排查完还没解决的话，直接去节点的日志目录（默认是/var/log/cassandra/）看system.log，里面会有详细的异常堆栈信息：

  • 如果看到WriteTimeoutException，大概率是副本节点响应慢或者不可达；
  • 如果是UnauthorizedException，就是当前用户没有写入users表的权限；
  • 如果是InvalidRequestException，可能是表结构和写入数据不匹配。

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