Elasticsearch无法识别新节点：添加同配置数据节点时报加入失败

第一步：先定位具体报错 #

直接查看新节点的ES运行日志，日志默认存储在$ES_HOME/logs/目录下，主日志文件名为[你的集群名].log，筛选ERROR/WARN级别、包含discovery/join/master关键词的条目，就能拿到具体的失败原因，不用盲目排查。

常见失败原因及解决方法（按出现概率从高到低排序） #

• 遗留集群初始化参数
  直接复制现有节点配置文件时，大概率会残留仅在集群第一次启动时生效的参数cluster.initial_master_nodes。这个参数的作用是初始化集群时指定初始主节点，后续新增节点绝对不能配置，否则会尝试自建全新集群，自然无法加入现有集群。直接删掉该配置项即可。
• 集群名配置错误
  哪怕你只修改了node.name，也要核对cluster.name配置和现有集群完全一致：ES的集群名区分大小写，多余的空格、大小写偏差都会导致新节点匹配不到目标集群。
• 种子节点配置错误
  核对discovery.seed_hosts配置，确保列表内填写的是现有集群合格主节点的IP:9300地址，不要误填新节点自身的IP，也不要填已经下线的节点地址，否则新节点无法发现集群主节点，加入会超时失败。
• 9300传输端口未放行
  ES集群节点之间通信默认走transport.port（默认9300），和对外提供服务的9200 HTTP端口无关。在新节点上执行nc -zv [现有任意主节点IP] 9300，确认能连通，同时要保证现有节点也能访问新节点的9300端口，排查新节点、集群路径上的防火墙、安全组是否放行9300端口的双向流量。
• data目录残留旧集群数据
  如果新节点之前测试部署过ES，path.data对应的目录下会残留旧集群的唯一标识UUID，节点启动时会默认归属之前的集群，和现有集群UUID不匹配就会拒绝加入。直接清空path.data对应目录下的所有内容，再重启新节点即可。
• ES版本不匹配
  核对新节点的ES版本：在新节点的ES安装目录下执行./bin/elasticsearch --version拿到版本号，和现有集群任意节点的版本对比（可通过curl [现有节点IP]:9200返回的version字段查看）。ES要求集群内所有节点的大版本号完全一致，次版本号偏差不能超过1个小版本，跨大版本（比如现有是7.x，新节点是8.x）会直接被拒绝加入。
• 安全认证配置异常
  如果现有集群开启了X-Pack安全认证，要逐一核对：
  • 配置里涉及的证书、密钥文件（比如elastic-certificates.p12）已经完整拷贝到新节点对应的路径下
  • 证书文件权限为600，且归属ES运行用户，不能被其他用户读取
  • xpack.security相关的所有配置项和现有数据节点完全一致，没有漏改IP、本地路径这类细节。

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