如何将含逗号的Docker环境变量注入Spring属性

方案1：自定义Spring列表分隔符 #

Spring默认用逗号作为列表项的分隔符，你可以通过环境变量指定一个不冲突的分隔符（比如|），这样正则里的逗号就不会被误拆分：

启动容器时添加额外环境变量：

docker run -e SPRING_CONFIG_LIST_DELIMITER="|" -e URL_PATTERN_REGEX_LIST="你的正则内容" 镜像名

如果需要传递多个正则，用|分隔即可；单个正则直接传递，内部逗号不会被处理。

方案2：用引号包裹并正确转义 #

在传递URL_PATTERN_REGEX_LIST时，用单引号或双引号包裹整个正则字符串，避免Shell和Docker解析内部的逗号：

直接用docker命令传递 #

docker run -e 'URL_PATTERN_REGEX_LIST="(?i)(https?:\/\/)?[-a-z\p{L}A-Z0-9@:\.]{1,256}\.[-a-zA-Z0-9\p{L}]{2,20}[-a-zA-Z0-9@:%_\+\.~\"*\=\p{L}]*\/[-a-zA-Z0-9@:()_\+\.~#?&\"%\*\/=\p{L}]*"' 镜像名

注意外层用单引号，内层正则的双引号要转义（\"）。

用docker-compose.yml传递 #

在docker-compose文件里，用单引号包裹整个值，同时转义正则里的反斜杠：

services:
  your-app:
    image: 镜像名
    environment:
      URL_PATTERN_REGEX_LIST: "'(?i)(https?:\\\\/\\\\/)?[-a-z\\\\p{L}A-Z0-9@:\\\\.]{1,256}\\\\.[-a-zA-Z0-9\\\\p{L}]{2,20}[-a-zA-Z0-9@:%_\\\\+\\\\.~\"*=\\\\p{L}]*\\\\/[-a-zA-Z0-9@:()_\\\\+\\\\.~#?&\"%\\\\*\\\\/=\\\\p{L}]*'"

方案3：使用SPRING_APPLICATION_JSON传递JSON格式配置 #

Spring支持通过SPRING_APPLICATION_JSON环境变量直接传递JSON结构的配置，这种方式能精准定义列表，完全避免逗号拆分问题：

docker run -e 'SPRING_APPLICATION_JSON={"url-pattern-regex-list": ["(?i)(https?:\/\/)?[-a-z\p{L}A-Z0-9@:\.]{1,256}\.[-a-zA-Z0-9\p{L}]{2,20}[-a-zA-Z0-9@:%_\+\.~\"*\=\p{L}]*\/[-a-zA-Z0-9@:()_\+\.~#?&\"%\*\/=\p{L}]*"]}' 镜像名

如果需要多个正则，直接在JSON数组里添加即可，比如：

docker run -e 'SPRING_APPLICATION_JSON={"url-pattern-regex-list": ["正则1", "正则2"]}' 镜像名

方案4：挂载外部配置文件 #

如果环境变量传递过于繁琐，可以把包含正确正则列表的配置文件挂载到容器内：

1. 新建custom-config.yml文件，内容如下：

url-pattern-regex-list:
  - '(?i)(https?:\/\/)?[-a-z\p{L}A-Z0-9@:\.]{1,256}\.[-a-zA-Z0-9\p{L}]{2,20}[-a-zA-Z0-9@:%_\+\.~\"*\=\p{L}]*\/[-a-zA-Z0-9@:()_\+\.~#?&\"%\*\/=\p{L}]*'
  # 可添加更多正则

2. 启动容器时挂载该文件：

docker run -v ./custom-config.yml:/app/config/application.yml 镜像名

（注意路径要根据你的应用配置目录调整）

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