ARM架构Mac本地k8s集群端口无法接收fetch请求故障排查

问题根源 #

1. 请求地址逻辑错误：你前端代码中写的fetch("http://localhost:5000/")是从终端用户的浏览器发起请求，localhost指向的是用户本地设备，不是K8s集群内部的server服务。
2. 服务未对外暴露：你当前配置的server Service是ClusterIP类型，这类IP仅在K8s集群内部可访问，你的Mac本地、用户浏览器都无法直接访问ClusterIP，所以请求直接被拒绝，你看到的CORS提示是请求失败后的附带现象，并非核心问题。
3. 可选检查：确认express服务监听地址为0.0.0.0，如果是监听127.0.0.1会导致集群内其他Pod也无法访问，修改监听代码为：

app.listen(PORT, '0.0.0.0', function () {
  console.log("listening on 5000");
});

你可以先执行以下命令验证集群内部服务是否正常：

kubectl run -it --rm busybox --image=busybox:1.28 -- wget -qO- http://server-cluster-ip-service.default.svc.cluster.local:5000

如果能正常返回接口数据，说明server本身和ClusterIP Service配置正常，问题仅出在外部访问入口配置。

解决方案 #

方案1：本地调试用端口转发 #

直接用kubectl端口转发将本地Mac的5000端口映射到集群内的server服务：

kubectl port-forward service/server-cluster-ip-service 5000:5000

转发保持生效期间，你本地访问localhost:5000就可以正常请求到server服务。

方案2：修改Service为NodePort类型对外暴露 #

将server Service的类型改为NodePort，配置示例：

apiVersion: v1
kind: Service
metadata:
  name: server-cluster-ip-service
spec:
  type: NodePort
  selector:
    component: server
  ports:
    - port: 5000
      targetPort: 5000
      nodePort: 30500 # 可选，指定30000-32767之间的可用端口

修改后可以通过http://<你的K8s节点IP>:30500访问server服务，前端fetch地址替换为对应地址即可。

方案3：用Ingress统一暴露（推荐，可避免跨域） #

配置Ingress资源，将同一个域名的不同路径分别转发到前端和后端服务，示例配置：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: app-ingress
spec:
  rules:
  - host: local-app.test
    http:
      paths:
      - path: /api
        pathType: Prefix
        backend:
          service:
            name: server-cluster-ip-service
            port:
              number: 5000
      - path: /
        pathType: Prefix
        backend:
          service:
            name: client-cluster-ip-service # 替换为你的前端Service名称
            port:
              number: 80 # 替换为你的前端服务端口

配置后将local-app.test指向你的K8s节点IP写入本地hosts，前端直接请求/api路径即可，不需要写完整域名端口，天然避免跨域问题。

补充CORS配置 #

服务连通后如果仍然存在跨域报错，给express服务添加CORS中间件即可：

1. 安装依赖：npm install cors
2. 代码中添加配置：

const cors = require('cors');
app.use(cors());

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