Helm模板报错：Range无法遍历map类型返回值

报错原因 #

你用include调用模板时，include会将模板渲染的结果转换成字符串返回——哪怕模板里输出的是map类型，最终拿到的也是类似map[TIMEOUTS: 60 OPTIONS: ...]的字符串格式，而range只能迭代实际的Go map/切片，无法直接处理字符串，因此触发报错。

解决方案 #

通过fromYaml函数将include返回的字符串解析成实际的map类型，再进行迭代。修改后的调用代码如下：

{{- $mergedEnv := include "test.mergedEnvVars" . | fromYaml }}
{{- range $name, $value := $mergedEnv }}
{{- if (typeIs "string" $value) }}
- name: {{ $name }}
  value: {{ $value | quote }}
{{- else }}
- name: {{ $name }}
  {{- toYaml $value | nindent 14 }}
{{- end }}
{{- end }}

额外优化（可选） #

如果envVars或合并后的结果可能为空，建议增加空值判断，避免潜在的空迭代问题：

{{- $mergedEnv := include "test.mergedEnvVars" . | fromYaml }}
{{- if $mergedEnv }}
{{- range $name, $value := $mergedEnv }}
{{- if (typeIs "string" $value) }}
- name: {{ $name }}
  value: {{ $value | quote }}
{{- else }}
- name: {{ $name }}
  {{- toYaml $value | nindent 14 }}
{{- end }}
{{- end }}
{{- end }}

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