Citus 11是否支持高可用（HA）？故障场景求助

一、Citus 11对高可用的支持 #

Citus 11完全支持高可用架构，可搭配pg_autofailover、Patroni这类PostgreSQL生态的HA方案实现节点故障切换。但要注意：协调器（Coordinator）的核心元数据表pg_dist_node必须和底层PostgreSQL的HA状态同步，否则会出现请求路由错误。

二、故障根因分析 #

你遇到的connection with remote worker1_primary refused错误，本质是Citus元数据未同步pg_autofailover的节点切换结果：

• 当worker1_primary被禁用后，pg_autofailover会将对应standby节点提升为新主，但Cordinator的pg_dist_node表中仍标记worker1_primary为活跃的主节点，导致插入操作依然尝试连接已失效的节点，最终触发连接拒绝错误。

三、修复步骤 #

1. 确认新主节点状态 #

先验证worker1组的新主节点（原standby）已正常完成主备切换，PostgreSQL服务运行正常、端口可正常访问。

2. 手动更新Citus元数据 #

在Coordinator节点执行以下SQL，修正pg_dist_node表的状态：

• 标记旧主节点为不可用：

  UPDATE pg_dist_node SET nodeisactive = false WHERE nodename = 'worker1_primary的主机名/IP' AND nodeport = 对应端口;
  

• 将新主节点设置为primary并标记为活跃：

  UPDATE pg_dist_node SET noderole = 'primary', nodeisactive = true WHERE nodename = '新主节点的主机名/IP' AND nodeport = 对应端口;
  

3. 验证修复效果 #

执行插入测试，确认协调器已将请求路由到新的worker主节点，无连接错误。

4. 长期优化：实现元数据自动同步 #

为避免手动更新的繁琐，可通过以下方式实现自动同步：

• 利用pg_autofailover的回调脚本，在节点切换完成后自动触发Citus元数据更新。
• 编写定时任务，定期对比pg_autofailover的节点状态与pg_dist_node表，发现不一致时自动修正。

四、关键注意事项 #

• 所有worker节点的主备切换操作，必须同步更新pg_dist_node表的noderole和nodeisactive字段，这两个字段是Cordinator路由请求的核心依据。
• Citus 11中，pg_dist_node的noderole取值为primary或standby，nodeisactive为true时才会被协调器选为可用节点。

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