修改YugabyteDB broadcast_address后master启动报错排查方案

• Master服务确实会持久化留存集群初始化时写入的节点配置信息，不会随启动时绑定地址的修改自动更新旧的peer节点记录。
• 最初用公网服务器地址初始化实例时，旧节点地址10.20.12.246:7100已经被写入master元数据，修改绑定地址为localhost后，master启动时仍会尝试和元数据中记录的旧地址建立通信，该地址当前无服务监听，就会触发你看到的连接拒绝报错，最终导致master启动失败。

根据是否需要保留原有集群数据，选择对应方案操作：

方案一：无需保留历史数据（测试/临时环境适用） #

• 终止所有运行中的yb-master、yb-tserver进程
• 清空启动参数中--fs_data_dirs指定的数据存储目录下的所有文件（默认路径通常为/var/lib/yugabyte/或安装目录下的data文件夹）
• 同步修改master、tserver的所有启动地址参数：将--rpc_bind_addresses、--webserver_interface、--master_addresses等涉及服务监听、节点通信的地址项统一配置为127.0.0.1，其中master通信端口保持7100、tserver通信端口保持9100不变
• 按顺序先启动master进程、再启动tserver进程，即可完成绑定localhost的全新单节点集群初始化。

方案二：需要保留原有业务数据 #

• 先将启动配置中的地址参数改回最初的公网服务器地址，正常启动集群，确认master、tserver运行状态正常
• 执行元数据更新操作，替换master节点记录地址，单节点场景执行以下命令即可：

# 先移除旧地址的master节点记录
./bin/yb-admin -master_addresses <旧公网IP>:7100 change_master_config REMOVE_SERVER <旧公网IP> 7100
# 新增localhost地址的master节点记录
./bin/yb-admin -master_addresses <旧公网IP>:7100 change_master_config ADD_SERVER 127.0.0.1 7100

• 等待元数据同步完成（等待10-30秒即可），终止所有yb相关进程
• 将启动配置中所有涉及地址的参数统一修改为127.0.0.1，重新启动master、tserver进程即可，原有业务数据会完整保留。

注意：绑定localhost的单节点YugabyteDB仅支持本机访问，无法对外提供数据库服务，且无高可用能力，不建议在生产环境使用该配置。

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