如何解决Kubernetes中Spring Cloud Gateway CORS配置的无效字符问题？

场景与现有配置 #

我的values.yaml配置如下：

test:
  cors:
    allowedOrigins: 'https://www.test.com'

需要覆盖的Spring Cloud Gateway原生配置：

spring:
  application:
    name: something
  cloud:
    gateway:
      globalcors:
        corsConfigurations:
          '[/**]':
            allowedOrigins: 'https://www.host.com'

尝试的方法及错误 #

我尝试通过环境变量动态注入配置，写法如下：

- name: SPRING_CLOUD_GATEWAY_GLOBALCORS_CORSCONFIGURATIONS_[/**]_ALLOWEDORIGINS
  value: {{ .Values.test.cors.allowedOrigins | quote }}

但触发Kubernetes报错：

SPRING_CLOUD_GATEWAY_GLOBALCORS_CORSCONFIGURATIONS_[/**]ALLOWEDORIGINS": a valid environment variable name must consist of alphabetic characters, digits, '', '-', or '.', and must not start with a digit (e.g. 'my.env-name', or 'MY_ENV.NAME', or 'MyEnvName1', regex used for validation is '[-._a-zA-Z][-._a-zA-Z0-9]*')

原因是Kubernetes环境变量名称不允许包含[、]、/这类特殊字符。

解决方案 #

方法1：挂载Spring配置文件（推荐） #

通过ConfigMap挂载自定义的Spring配置文件，直接引用values.yaml中的值，这种方式更直观且不易出错。

1. 定义ConfigMap模板：

apiVersion: v1
kind: ConfigMap
metadata:
  name: gateway-cors-config
data:
  application-cors.yml: |
    spring:
      cloud:
        gateway:
          globalcors:
            corsConfigurations:
              '[/**]':
                allowedOrigins: {{ .Values.test.cors.allowedOrigins | quote }}

2. 在Deployment中挂载该ConfigMap到Spring Boot默认加载的配置目录（如/config）：

containers:
- name: gateway-service
  image: your-gateway-image:tag
  volumeMounts:
  - name: cors-config-volume
    mountPath: /config
volumes:
- name: cors-config-volume
  configMap:
    name: gateway-cors-config

Spring Boot会自动加载/config目录下的配置文件，覆盖默认配置。

方法2：使用合规的环境变量格式 #

根据Spring Boot的环境变量转义规则，将特殊字符替换为合规格式：
原配置路径spring.cloud.gateway.globalcors.corsConfigurations.[/**].allowedOrigins对应的合规环境变量名需要将[/**]转义为__STAR_STAR__，最终写法如下：

- name: SPRING_CLOUD_GATEWAY_GLOBALCORS_CORSCONFIGURATIONS___STAR_STAR__ALLOWEDORIGINS
  value: {{ .Values.test.cors.allowedOrigins | quote }}

注：这里的___STAR_STAR__是将[/**]中的*转义为STAR，并用下划线包裹，符合Spring Boot的环境变量转义规则，同时满足Kubernetes的环境变量命名要求。

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