YAML转JSON失败排查：新增Helm range语句后出现语法错误

核心错误原因 #

你遇到的YAML解析错误，大概率是Helm range语法误用或YAML缩进/格式破坏导致的，以下是具体问题点和修复方式：

1. Range语法错误（最常见） #

你写的{{- range .Values.ipRanges | quote }}是错误写法：

• range接收的是可迭代对象（比如数组），不能直接给range加quote管道，quote应该作用于循环内的每个元素，而非整个range输入。
• 正确写法应该是在循环体内对单个元素加引号：

  {{- range .Values.ipRanges }}
    - "{{ . }}"
  {{- end }}
  

2. YAML缩进错误 #

新增的三行代码如果没有和父级key保持一致的缩进，会被YAML解析器识别为无效的顶级key，触发did not find expected key错误。

• 示例（正确缩进，假设父级是spec.loadBalancerSourceRanges）：

  spec:
    type: LoadBalancer
    loadBalancerSourceRanges:
    {{- range .Values.ipRanges }}
      - "{{ . }}"
    {{- end }}
  

  注意：循环内的- "{{ . }}"必须和父级的数组元素缩进对齐。

3. 循环输出格式破坏 #

如果range循环输出的内容不符合YAML数组格式（比如缺少- 前缀、元素间没有正确分隔），会直接破坏YAML结构。

• 错误示例（缺少- ）：

  {{- range .Values.ipRanges }}
    "{{ . }}"
  {{- end }}
  

  这种写法会把所有IP直接拼接成字符串，而非数组元素，导致YAML解析失败。

4. 值类型不匹配 #

如果values.yaml中的ipRanges不是数组类型（比如是单个字符串、null或未定义），range循环会输出无效内容，破坏YAML结构。

• 确保values.yaml中ipRanges是数组：

  ipRanges:
    - "192.168.1.0/24"
    - "10.0.0.0/8"
  

排查验证步骤 #

1. 用helm template渲染模板，查看生成的原始YAML，直接定位语法问题：

   helm template your-chart-name --set ipRanges[0]="192.168.1.0/24"
   

2. 检查渲染后的YAML是否符合数组格式，比如是否有多余的引号、缺失的-或缩进错误。

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