GKE BackendConfig配置customRequestHeaders自定义请求头不生效问题

问题根因 #

1. Ingress类型不匹配：你配置的BackendConfig是GCP官方为GKE默认的gce类Ingress（对应GCP HTTP/HTTPS负载均衡）提供的自定义配置资源，完全不适用于你当前用的Nginx Ingress，所以写的自定义请求头配置根本没有生效。
2. 流量路径不符合预期：你的Service类型设置为LoadBalancer，会直接创建GCP的TCP负载均衡对外暴露服务，流量如果直接走这个LB的话，完全不会经过Ingress，更不会触发任何请求头注入逻辑。

解决方案1：改用GCE Ingress（推荐，可直接使用GCP原生的地理位置变量） #

如果你要使用GCP LB原生提供的客户端地理位置变量，直接切换为GCE Ingress即可，改动如下：

修改Ingress配置 #

把Ingress的annotations替换为GCE Ingress的对应配置：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-service
  annotations:
    kubernetes.io/ingress.class: gce # 替换原来的nginx类配置
    kubernetes.io/ingress.allow-http: "false" # 可选，禁用HTTP仅开放HTTPS
spec:
  rules:
    - host: app.example.com
      http:
        paths:
          - path: /api/v1
            pathType: Prefix
            backend:
              service:
                name: npm-app-service
                port:
                  number: 80

修改Service配置 #

把Service类型改为ClusterIP，不需要LoadBalancer类型：

apiVersion: v1
kind: Service
metadata:
  name: npm-app-service
  namespace: my-app-ns-prod
  annotations:
    cloud.google.com/backend-config: '{"ports": {"80":"npm-app-backendconfig"}}'
    cloud.google.com/neg: '{"ingress": true}'
spec:
  selector:
    app: npm-app-pod
    tier: backend
  ports:
    - name: http
      protocol: TCP
      port: 80
      targetPort: 3000
  type: ClusterIP # 替换原来的LoadBalancer类型

验证注意 #

配置更新后等待10-15分钟让GCE Ingress和LB配置完全生效，Node.js框架（如Express/Koa）会自动将请求头转换为全小写格式，你可以直接打印req.headers查看所有传入的头确认正确的键名，避免按配置的驼峰/大写名称查找不到。

解决方案2：继续使用Nginx Ingress #

如果你要保留Nginx Ingress，需要用Nginx Ingress的规则来注入请求头，GCP的地理位置变量需要先透传到Nginx，再由Nginx注入到上游请求中，步骤如下：

1. 删除之前配置的BackendConfig资源，Nginx Ingress不识别该资源。
2. 修改Ingress的annotations，添加自定义请求头配置：

metadata:
  name: ingress-service
  annotations:
    kubernetes.io/ingress.class: nginx
    nginx.ingress.kubernetes.io/use-regex: "true"
    # 用Nginx的配置注入请求头，变量对应GCP LB传递给Nginx的头
    nginx.ingress.kubernetes.io/configuration-snippet: |
      proxy_set_header X-Client-CityLatLong $http_x_client_city_lat_long;
      proxy_set_header X-Client-Region $http_x_client_region;
      proxy_set_header X-Client-Region-SubDivision $http_x_client_region_subdivision;
      proxy_set_header X-Client-City $http_x_client_city;

3. 确保你部署Nginx Ingress时创建的前端LB已经开启了自定义请求头注入，否则Nginx侧拿不到对应的地理位置变量。

额外检查项 #

• 不要用本地localhost或者内网IP访问测试，必须从公网访问Ingress的公网IP或者绑定的域名，LB才能识别到客户端的地理位置信息。
• 部分区域级变量需要对应GCP LB的功能开启后才会生成，可检查LB的配置是否已开放地理位置字段注入。

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