部署在Minikube上的MERN应用无法通过NodePort访问求助

以下是针对你遇到的访问超时问题的排查和解决步骤：

1. 确认访问地址的正确性 #

首先确保你使用的是正确的节点IP和NodePort：

• 获取Minikube节点IP：执行 minikube ip
• 获取前端Service的NodePort：执行 kubectl get svc frontend-svc，查看输出中的PORT(S)列，格式为8080:xxxx/TCP，其中xxxx就是你需要使用的NodePort（范围30000-32767）

注意：你的配置中没有指定nodePort字段，Kubernetes会自动分配一个随机端口，不要直接使用容器端口8080访问。

2. 验证前端Pod状态与日志 #

检查前端Pod是否正常运行并启动成功：

• 查看Pod状态：kubectl get pods -l app=frontend-pod，确保状态为Running
• 查看Pod启动日志：kubectl logs <你的前端Pod名称>，检查是否有应用启动错误，比如端口监听失败、依赖缺失等。

3. 检查Service与Pod的端点关联 #

确认Service已正确关联到Pod：

• 执行 kubectl describe svc frontend-svc，查看Endpoints字段，如果显示为<Pod-IP>:8080，说明关联正常；如果为空，需再次核对Deployment的Pod标签和Service的selector是否完全匹配（你的配置中标签是匹配的，但建议再次确认）。

4. 测试集群内部访问连通性 #

在Minikube集群内部测试前端Service是否可访问：

• 启动一个临时测试Pod：kubectl run -it --rm --image=curlimages/curl test-curl
• 在测试Pod内执行：curl frontend-svc:8080，如果能返回前端页面内容，说明Service到Pod的通路正常，问题出在外部访问的网络层面；如果无法访问，说明Pod内部应用存在问题。

5. 修复前端应用的监听地址（常见原因） #

很多React应用默认只监听localhost，导致容器外部无法访问。需要确保应用监听0.0.0.0：

• 如果你有权限修改前端代码，在package.json的start脚本中添加--host 0.0.0.0：

  "scripts": {
    "start": "react-scripts start --host 0.0.0.0"
  }
  

• 重新构建镜像并替换现有Deployment中的镜像，或者检查你使用的achref2h/bookstore-frontend:latest镜像是否已配置为监听0.0.0.0。

6. 使用Minikube内置命令简化访问 #

直接使用Minikube的service命令自动处理端口转发并打开浏览器：

minikube service frontend-svc

这个命令会自动配置端口转发，避免手动输入IP和端口可能出现的错误。

7. 排查防火墙与网络策略 #

• 检查Minikube所在主机的防火墙规则，确保已开放对应的NodePort端口
• 如果你的集群配置了网络策略，确认没有阻止对前端Service的外部访问（默认Kubernetes没有网络策略，此步骤仅针对有自定义网络策略的场景）

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