K3s集群Etcd连接失败问题排查求助

核心问题定位 #

从日志可见，K3s无法连接本地Etcd（context deadline exceeded），且启动时提示2379端口被占用——根源是你手动启动了独立Etcd实例，和K3s内置的Etcd集群端口冲突，导致K3s无法正常初始化内置Etcd服务。

分步修复 #

• 定位端口占用进程
  执行命令找出占用2379端口的进程：

  ss -tulpn | grep 2379
  # 若系统有lsof工具，也可使用
  lsof -i :2379
  

  输出结果中的PID即为占用端口的进程ID，大概率是你手动启动的Etcd。

• 停止冲突进程并清理残留
  强制杀掉占用端口的进程：

  kill -9 <进程PID>
  

  同时清理K3s的残留进程，避免状态混乱：

  ps aux | grep k3s | grep -v grep | awk '{print $2}' | xargs kill -9
  

• 禁用独立Etcd服务（若存在）
  如果手动安装的Etcd通过systemd管理，禁止其开机启动并停止服务：

  systemctl disable --now etcd
  

• 重启K3s服务并验证
  重启K3s master节点服务：

  systemctl restart k3s
  

  验证Etcd集群健康状态：

  k3s etcd endpoint health
  

  检查K3s服务状态和集群节点：

  systemctl status k3s
  kubectl get nodes
  

• 处理Etcd集群异常（若上述步骤无效）
  如果集群存在Etcd节点脑裂或数据损坏，先在可用的master节点上列出Etcd成员：

  k3s etcd member list
  

  移除状态异常的成员（替换<member-id>为实际成员ID）：

  k3s etcd member remove <member-id>
  

  再次重启K3s服务，等待集群同步完成。

注意事项 #

K3s高可用集群默认使用内置Etcd集群，无需手动部署独立Etcd实例，否则会引发端口冲突、集群状态不一致等问题。

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