Kubernetes 1.28（Beta）及1.22+（Alpha）版本需显式启用NodeSwap特性门控并配置memorySwap策略，否则kubelet启动失败或Pod无法使用Swap；须确保cgroup v2与systemd驱动启用，通过swapon --show、/proc/sys/vm/swappiness及kubelet配置验证。
在Kubernetes 1.28（Beta）及1.22+（Alpha）版本中，需显式启用NodeSwap特性门控并配置memorySwap策略，否则kubelet启动失败或Pod无法使用Swap。
确认节点Swap状态与内核支持
执行swapon --show检查当前Swap是否已启用；若输出为空，说明未启用，需先创建Swap文件：sudo dd if=/dev/zero of=/swapfile bs=1G count=2 && sudo mkswap /swapfile && sudo chmod 600 /swapfile && sudo swapon /swapfile。
运行cat /proc/sys/vm/swappiness，值必须大于0（默认为60），否则Swap不会触发；若为0，执行sudo sysctl vm.swappiness=60临时生效，并写入/etc/sysctl.conf永久保存。
【必须确保cgroup v2已启用且systemd作为cgroup驱动】：Kubernetes 1.22+启用NodeSwap的前提是节点使用cgroup v2和systemd驱动，可通过mount | grep cgroup确认挂载类型，并检查kubelet配置中cgroupDriver: systemd已设置。
配置Kubelet启用NodeSwap特性
方法一：通过/var/lib/kubelet/config.yaml修改（推荐）
① 停止kubelet：sudo systemctl stop kubelet。
② 在config.yaml末尾添加以下四行（注意缩进对齐，YAML对空格敏感）：
featureGates: NodeSwap: truememorySwap: swapBehavior: UnlimitedSwap
③ 重启kubelet：sudo systemctl start kubelet；若报错，请检查YAML语法，尤其featureGates与memorySwap是否同级、是否被其他字段意外缩进。
方法二：通过systemd环境变量（适用于1.22–1.27）
编辑/etc/systemd/system/kubelet.service.d/10-kubeadm.conf，在Environment=行追加--fail-swap-on=false，例如：Environment="KUBELET_EXTRA_ARGS=--fail-swap-on=false"；然后执行sudo systemctl daemon-reload && sudo systemctl restart kubelet。
验证Swap功能是否就绪
执行kubectl get node -o wide，查看节点状态是否为Ready；若仍NotReady，用journalctl -u kubelet -n 100 --no-pager排查错误日志，重点搜索NodeSwap或memorySwap相关提示。
运行kubectl describe node ，在Capacity和Allocatable字段中查找memory.swap条目；若存在且数值非零，说明kubelet已识别Swap资源。
部署一个声明swap limit的Pod（如swap: "512Mi"），观察其是否能成功调度并运行；若Pod卡在Pending状态且事件显示Insufficient memory.swap，说明集群未正确暴露Swap容量，需回查kubelet配置与cgroup设置。
