Skaffold debug运行时部分服务启动失败、报错无规律问题求助

问题解决方案 #

1 解决CPU资源不足报错

Docker Desktop默认分配给WSL2运行环境的资源配额不足是核心问题之一，哪怕主机硬件配置足够，也会导致K8s调度Pod失败：

• 打开Docker Desktop设置面板，进入Resources > Advanced选项卡，将CPU核数调整为≥4核，内存调整为≥8GB，Swap调整为2GB，保存配置后重启Docker生效。
• 为所有服务的Deployment配置资源限制，避免单个服务抢占过多资源，参考配置如下：

resources:
  requests:
    cpu: "100m"
    memory: "128Mi"
  limits:
    cpu: "500m"
    memory: "256Mi"

2 解决K8s API限流报错

Skaffold debug模式下会频繁请求K8s API拉取Pod状态，旧版本Skaffold的请求频率控制逻辑不完善会触发客户端限流：

• 升级Skaffold到最新稳定版本即可解决大部分限流问题。
• 也可以在执行skaffold debug时添加参数调高API请求阈值：skaffold debug --kube-api-qps=20 --kube-api-burst=30

3 解决NATS连接失败报错

CONNECTION_REFUSED和EAI_AGAIN报错均由服务启动顺序不匹配、服务发现延迟导致：业务服务启动速度快于NATS服务，NATS还未就绪、DNS还未完成nats-service解析就发起连接，直接触发报错。可按以下步骤修复：

• 为NATS Deployment添加就绪探针，确认NATS服务正常运行后再标记Pod可用，参考配置：

readinessProbe:
  tcpSocket:
    port: 4222
  initialDelaySeconds: 10
  periodSeconds: 5

• 调整业务服务代码，添加NATS连接重试逻辑，设置2秒重试间隔，至少重试10次，避免单次连接失败直接崩溃。
• 在skaffold.yaml中配置部署顺序，指定业务服务依赖NATS服务，保证NATS优先部署完成。

4 优化WSL2网络稳定性

WSL2默认DNS配置不稳定也会导致服务域名解析失败，可修改配置修复：

• 编辑WSL2内的/etc/wsl.conf，添加以下内容禁用自动生成DNS配置：

[network]
generateResolvConf = false

• 手动创建/etc/resolv.conf，写入以下DNS配置：

nameserver 8.8.8.8
nameserver 172.17.0.1

• 执行wsl --shutdown重启WSL2生效。

验证步骤 #

所有配置修改完成后，先执行kubectl delete all --all清空当前命名空间的残留资源，再执行skaffold debug验证是否能稳定启动所有服务。

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