You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Kubernetes集群Pod内部连通正常但浏览器无法访问后端服务如何排查?

问题根因与排查方案

核心根因

你遇到的问题本质是React应用属于客户端渲染,代码最终运行在用户的浏览器侧,而非前端Pod内部:
你配置的REACT_APP_BACKEND_HOST值是K8s集群内部的ClusterIP段地址(10.233.x.x),只有集群内部的Pod/节点能访问这个网段,公网用户的浏览器没有通往该内部网段的路由,所以必然请求超时。而你在前端Pod内部curl能通,就是因为Pod本身处于集群网络中。

排查步骤

  1. 先打开浏览器F12控制台,切换到网络标签页,确认报错的请求目标地址确实是10.233.62.29这个集群内部IP,确认配置问题。
  2. 执行kubectl get endpoints plg-backend,确认后端Service的端点正常,能关联到运行中的后端Pod,排除Service配置错误。
  3. 如果你已经把后端对外暴露,可直接在本地执行telnet 你的节点公网IP 后端暴露端口,确认网络连通性,排除防火墙/安全组配置问题。

解决方案

根据你的使用场景选以下任意一种即可:

  • 方案1:将后端Service也改为NodePort类型,对外暴露端口,将REACT_APP_BACKEND_HOST的值改为http://你的K8s节点公网IP:后端NodePort,同时放开对应端口的防火墙规则。
  • 方案2(推荐生产用):部署Ingress组件,统一对外暴露服务,配置Ingress规则把/api前缀的请求转发到后端plg-backend Service,根路径请求转发到前端plg-frontend Service。这样前端代码里的后端地址可以直接写当前访问的域名/IP,不需要单独配置后端地址,还能天然避免跨域问题。
  • 方案3(仅本地测试用):在你运行浏览器的本地电脑上配置静态路由,把10.233.62.0/24网段的流量指向K8s集群的网关,让本地能直接访问集群内部IP。

额外注意

如果你用的是标准Create React App脚手架构建的镜像,要注意REACT_APP_开头的环境变量仅在镜像构建阶段生效,Pod运行时注入的env默认不会替换已经构建好的静态文件里的变量,需要在镜像启动脚本中额外加sed之类的逻辑替换占位符,否则配置不会生效。

内容的提问来源于stack exchange,提问作者AbreQueVoy

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.23 22:54:03