apisix-dashboard启动失败求助：无法连接etcd问题排查

• 确认etcd运行状态
  执行systemctl status etcd查看etcd是否正常启动，若未运行，启动服务：systemctl start etcd，并设置开机自启：systemctl enable etcd。也可通过etcdctl member list验证etcd集群状态。

• 测试本地etcd连通性
  执行curl http://127.0.0.1:2379/health，若返回{"health":"true"}则本地连通正常；若失败，检查etcd监听配置。

• 检查etcd监听地址配置
  打开etcd配置文件（通常路径为/etc/etcd/etcd.conf），确认listen-client-urls参数包含http://127.0.0.1:2379。若etcd绑定了其他IP（如0.0.0.0或内网IP），需同步修改dashboard的配置。

• 核对apisix-dashboard的config.yaml配置
  定位到dashboard的config.yaml文件，检查etcd相关配置段：

  etcd:
    endpoints:
      - "http://127.0.0.1:2379"
    # 若etcd开启认证，需确保username和password配置正确
    # username: "your_username"
    # password: "your_password"
  

  确保endpoints与etcd实际监听的地址、端口完全匹配，无拼写错误。

• 排查防火墙与SELinux限制

  • 临时关闭防火墙测试：systemctl stop firewalld，若问题解决，可永久放行2379端口：firewall-cmd --add-port=2379/tcp --permanent && firewall-cmd --reload
  • 检查SELinux状态：getenforce，若为Enforcing，临时关闭测试：setenforce 0，若恢复正常，需配置SELinux允许etcd端口访问。

• 重启相关服务
  执行systemctl restart etcd && systemctl restart apisix-dashboard，确保服务状态同步。

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