cni-plugin-failed

CNI 插件失败

现象

Pod 卡在 ContainerCreating，事件显示 failed to set up pod network、network plugin is not ready 或 CNI plugin not initialized；节点上新旧 Pod 网络不通。

快速定位

kubectl describe pod <POD> -n <NS> | grep -A20 Events
kubectl -n kube-system get pods | grep -E 'calico|cilium|flannel|kube-ovn|multus'
kubectl -n kube-system logs <CNI_POD> --tail=100

节点上检查 CNI 配置：

ls -l /etc/cni/net.d/
ls -l /opt/cni/bin/
crictl pods

常见根因

• CNI DaemonSet 未就绪或 CrashLoopBackOff。
• /etc/cni/net.d 配置缺失、冲突或权限错误。
• CNI 二进制文件缺失或版本不匹配。
• Pod CIDR 与节点网络冲突。
• 节点上的 iptables/nftables 规则被清理。
• 多 CNI 同时安装，配置互相覆盖。

修复

• 恢复 CNI DaemonSet，查看其日志和事件。
• 清理冲突的 CNI 配置，只保留一个主 CNI。
• 重新安装 CNI 二进制并确认路径。
• 检查 Pod CIDR、路由和防火墙。
• 重建受影响节点的网络命名空间或重启运行时。
• 修复后删除卡住的 Pod 让其重新创建。

相关命令

• kubectl describe pod — 网络事件
• kubectl logs — CNI 日志
• crictl — 容器和 Pod 状态
• ip / iptables / nft — 节点网络
• cilium status / calicoctl — CNI 专用诊断