开发环境下无法通过端口转发连接Vite Pod

1. 确认端口转发命令的正确性 #

确保你执行的端口转发命令目标正确：

• 转发到Service的命令格式：

kubectl port-forward service/<你的服务名> 56020:80

• 直接转发到Pod的命令格式：

kubectl port-forward pod/<你的Pod名称> 56020:80

先尝试直接转发Pod，快速排除Service层面的问题。

2. 验证Pod状态与服务运行情况 #

• 检查Pod是否正常运行：

  kubectl get pods
  

  确认Pod状态为Running，重启次数无异常。

• 查看Pod日志，确认Vite服务启动状态：

  kubectl logs <你的Pod名称>
  

  日志中应出现类似Local: http://localhost:80、Network: http://<PodIP>:80的内容，说明服务已正确监听0.0.0.0:80。

• 进入Pod内部检查端口监听：

  kubectl exec -it <你的Pod名称> -- /bin/bash
  # 若缺少工具先安装
  apt update && apt install -y net-tools
  netstat -tulpn | grep 80
  

  需看到node进程监听0.0.0.0:80。

3. 检查Service与Pod的标签匹配 #

• 查看Pod的实际标签：

  kubectl describe pod <你的Pod名称> | grep Labels
  

• 查看Service的Selector配置：

  kubectl describe service <你的服务名> | grep Selector
  

  确保两者的app标签完全一致，避免Chart模板渲染后出现拼写错误。

4. 检查Service的端点状态 #

Service的端点列表必须包含运行中Pod的IP：

kubectl get endpoints <你的服务名>

如果ENDPOINTS列为空，说明Service未匹配到任何Pod，需重新核对标签或Pod状态。

5. 排查网络策略与本地防火墙 #

本地K8s集群（如Minikube、Kind）默认无网络策略，但如果集群配置了相关规则，需确认是否允许外部流量访问Pod/Service；同时检查本地机器防火墙是否阻止了56020端口的流量。

额外调整方向 #

• 确认package.json中的dev命令为vite：若命令带有--port参数，需确保与配置文件的端口一致（命令行参数优先级高于配置文件）。
• 尝试将Vite配置的server.host改为'::'，同时监听IPv4和IPv6，避免监听范围限制。

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