Kubernetes环境下Vue+PHP前后端通信故障排查（Nginx+PHP-FPM）

核心问题定位 #

1. 后端Service端口映射错误：后端容器暴露的是80端口，但后端Service的ports字段未指定targetPort，默认会将Service的8001端口转发到容器的8001端口，而容器内实际监听的是80端口，导致端口不匹配，通信失败。
2. 前端环境变量的访问逻辑误解：Vue前端的VUE_APP_BACKEND_URL是在浏览器端生效的，集群内部的KubeDNS名称（如http://backend:8001/api）无法被外部浏览器解析，只能用后端LoadBalancer的外部IP或通过Ingress配置统一入口。

具体修复步骤 #

1. 修正后端Service的端口映射 #

修改backend-servicelb.yaml，添加targetPort: 80，确保Service的8001端口正确转发到容器的80端口：

apiVersion: v1
kind: Service
metadata:
  annotations:
    kompose.cmd: C:\kompose\kompose.exe convert
    kompose.version: 1.26.0 (40646f47)
  creationTimestamp: null
  labels:
    io.kompose.service: backend
  name: backend
spec:
  type: LoadBalancer
  ports:
    - port: 8001
      targetPort: 80  # 新增该行，指定容器端口
  selector:
    io.kompose.service: backend
status:
  loadBalancer: {}

2. 调整前端环境变量 #

将前端的VUE_APP_BACKEND_URL设置为后端LoadBalancer的外部IP加上Service端口8001，例如：

# frontend-deployment.yaml 中环境变量部分
env:
  - name: VUE_APP_BACKEND_URL
    value: http://<实际后端LB外部IP>:8001/api

注意：如果后续使用Ingress统一管理入口，可以将前端和后端配置在同一域名下，前端用相对路径/api调用后端，避免硬编码IP。

3. 修正后端APP_URL配置 #

后端PHP的APP_URL应使用集群内部的Service地址，确保后端内部生成链接时正确：

# backend-deployment.yaml 中环境变量部分
env:
  - name: APP_URL
    value: http://backend:8001  # 使用Service的KubeDNS名称+端口

4. 验证通信连通性 #

• 检查后端Service的Endpoint是否正常：

  kubectl describe service backend
  

  确认Endpoints字段显示后端Pod的IP和80端口，说明Service与Pod关联正常。
• 在前端容器内测试集群内部通信：

  kubectl exec -it <前端Pod名称> -- curl http://backend:8001/api
  

  如果能正常返回后端响应，说明集群内部通信正常，问题出在浏览器端的地址配置。

优化建议 #

• 避免为每个服务创建LoadBalancer，使用Ingress统一管理外部访问入口，减少资源消耗并简化配置。
• 对于集群内部服务间通信，始终使用Service的KubeDNS名称（如http://backend:8001），无需依赖外部IP。

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