Helm YAML嵌套数组注入settings.json出现解析错误如何解决

DevOps 小满

2026-9-27

Helm嵌套数组JSON渲染错误解决方案

错误根因

Helm会优先对所有模板文件执行YAML语法校验。你当前的JSON配置是嵌在YAML格式的模板文件（如ConfigMap、Secret资源模板）中，toJson输出的嵌套数组符号[会被YAML解析器误认为是YAML的数组语法结构，而非JSON值的一部分，因此抛出「未找到预期key」的解析报错。

最优解决方案

使用YAML块标量符|声明JSON内容块，让YAML解析器直接跳过块内的语法校验，原样输出所有内容：

# 以ConfigMap模板为例，其余YAML格式模板使用逻辑一致
apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  # | 代表后续缩进层级的所有内容为纯文本，不做YAML语法解析
  settings.json: |
    {
      "CustomSetting": {
        "ArrayOfArrays": {{ .Values.customSetting.arrayOfArrays | toJson }}
      }
    }

该方案不会额外增加转义字符，最终生成的settings.json中ArrayOfArrays会是标准的嵌套数组类型，完全符合JSON格式要求。