Kubernetes环境下Nginx fastcgi_pass调用PHP报FastCGI协议版本错误求助

核心错误原因 #

你遇到的unsupported FastCGI protocol version: 72错误，本质是协议不匹配：

• 前端Nginx用fastcgi_pass发送的是FastCGI协议请求，但你指向的php-api-on-kubernetes.foo:80是K8s Ingress的HTTP端口，Ingress返回的是HTTP协议响应（HTTP响应的第一个字符是H，ASCII码正好是72），前端Nginx把HTTP响应当成FastCGI响应解析，自然报错。

旧环境能正常运行，是因为前端Nginx直接通过FastCGI协议连接PHP-FPM的端口（映射后的8087），而不是HTTP服务。

解决方案（两种可选） #

方案1：保持旧架构，前端直接连K8s内的PHP Service（推荐） #

这种方式完全沿用你之前的逻辑，不需要Ingress介入后端PHP的访问：

1. 确认PHP Service的可达性：
   • 如果前端Nginx也部署在K8s集群内，直接使用Service的集群域名访问：{{ .Release.Name }}:9000（你的Service名称就是{{ .Release.Name }}）
   • 如果前端Nginx在集群外，把PHP Service改成NodePort类型，或者用LoadBalancer（云环境），然后用节点IP:NodePort访问
2. 修改前端Nginx配置：

   location ~ \.php {
       # ... 保留原有的fastcgi_param等配置
       fastcgi_pass {{ php-service-name }}:9000; # 替换成集群内Service域名或外部可访问的地址
   }
   

3. 删除后端PHP的Ingress：因为前端直接连PHP-FPM，不需要Ingress转发HTTP请求

方案2：调整架构，后端PHP添加Nginx代理（适合需要对外暴露HTTP接口的场景） #

如果需要同时对外提供HTTP访问和给前端提供服务，可以给PHP Pod添加Nginx sidecar，让Nginx处理HTTP请求并转发给PHP-FPM：

1. 修改PHP Pod的Deployment，添加Nginx sidecar容器：

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: {{ .Release.Name }}
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: {{ .Release.Name }}
     template:
       metadata:
         labels:
           app: {{ .Release.Name }}
       spec:
         containers:
         - name: php-fpm
           image: 你的PHP镜像
           ports:
           - containerPort: 9000
         - name: nginx
           image: nginx:alpine
           ports:
           - containerPort: 80
           volumeMounts:
           - name: nginx-config
             mountPath: /etc/nginx/conf.d
         volumes:
         - name: nginx-config
           configMap:
             name: php-nginx-config
   

2. 创建Nginx配置的ConfigMap：

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: php-nginx-config
   data:
     default.conf: |
       server {
           listen 80;
           root /home/api/public;
   
           location ~ \.php$ {
               fastcgi_pass localhost:9000;
               fastcgi_index index.php;
               fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
               include fastcgi_params;
           }
       }
   

3. 修改PHP Service，指向Nginx的80端口：

   apiVersion: v1
   kind: Service
   metadata:
     name: {{ .Release.Name }}
   spec:
     selector:
       app: {{ .Release.Name }}
     ports:
     - port: 80
       targetPort: 80
       name: http
   

4. 修改Ingress配置（标准HTTP转发，不需要FCGI注解）：

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: {{ .Release.Name }}
   spec:
     ingressClassName: nginx
     rules:
       - host: {{ .Values.host }}
         http:
           paths:
             - path: /
               pathType: Prefix
               backend:
                 service:
                   name: {{ .Release.Name }}
                   port:
                     name: http
   

5. 修改前端Nginx配置，用proxy_pass代替fastcgi_pass：

   location ~ \.php {
       # ... 移除原有的fastcgi_param等配置，添加proxy相关配置
       proxy_pass http://php-api-on-kubernetes.foo;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
   }
   

对之前尝试的Ingress配置的说明 #

• 第一种带FCGI注解的Ingress：是让K8s Ingress控制器本身作为FastCGI客户端，把外部的HTTP请求转换成FastCGI协议发给PHP-FPM，再把FastCGI响应转换成HTTP返回给浏览器，所以浏览器能访问，但前端Nginx用FastCGI协议请求这个Ingress的HTTP端口，自然不兼容。
• 第二种无注解的Ingress：直接把HTTP请求转发给PHP-FPM的9000端口，PHP-FPM返回FastCGI响应，Ingress控制器无法解析，所以返回502，这是预期结果。

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