Helm Chart如何传递带多圆点的环境变量避免被解析为嵌套结构？

Helm 的 --set 命令行参数默认会将参数中的.识别为YAML结构的层级分隔符，因此你输入的env.server.servlet.context-path会被自动解析为嵌套Map结构：env -> server -> servlet -> context-path: /bpm/router-app，最终渲染时就会出现你看到的server: map[servlet:map[context-path:/bpm/router-app]]的异常结果。

• 方案1：转义命令行中的.字符
  在--set参数中，使用\.对键名中的.进行转义，告诉Helm该字符是键名的一部分而非层级分隔符。推荐用单引号包裹整个参数值避免shell额外转义：

helm install NAME nexus/stand --set 'env.server\.servlet\.context-path=/bpm/router-app'

如果不使用单引号，在Linux/macOS的Bash/Zsh环境下需要双转义处理：

helm install NAME nexus/stand --set env.server\\.servlet\\.context-path=/bpm/router-app

• 方案2：通过values文件传递参数（更稳定，无转义问题）
  新建一个自定义values.yaml文件，直接写入完整的带点键名：

env:
  server.servlet.context-path: /bpm/router-app

安装时用-f参数加载该文件即可：

helm install NAME nexus/stand -f values.yaml

• 方案3：模板层兼容（适合Chart维护者）
  如果希望用户不管是传嵌套结构还是直接传带点的键都能正常渲染，可以在模板中增加嵌套Map拍平逻辑，递归遍历所有嵌套的键，拼接成带.的完整环境变量名后再渲染。

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