使用Helm模板创建ConfigMap时遇类型错误：期望字符串，实际得[]interface {}

问题重现 #

配置文件代码 #

configmap.yaml

apiVersion: v1
kind: ConfigMap
metadata:
  name: abc
  labels:
    app: abc
    chart: {{ $.Chart.Name }}-{{ $.Chart.Version | replace "\"+\"" "\"-\"" }}
    release: {{ .Release.Name }}
    heritage: {{ .Release.Service }}
  namespace: {{ $.Release.Namespace }}

data:
  pqr.conf: |
    {{ $config := fromYaml (include "yyz.agentConfig" .) }}
    {{- $config | toYaml | nindent 4 }}

_uuu.tpl

{{/*
Config for the agent
The values can be overridden in .Values.agent.config
*/}}
{{- define "yyz.agentConfig" -}}
exporters:
  logs:
    uuu: {{ .Values.a.uuu | quote }}
    bnk: "${*****}"
    lqp: {{ .Values.a.lqp| quote }}
    qqq: {{ .Values.a.qqq | quote }}
    www: {{ .Values.a.www }}
    rrr: {{ .Values.a.rrr }}
{{ end }}

错误信息 #

Error: template: path/configmap.yaml:14:28: executing "path/configmap.yaml" at <include "yyz.agentConfig" .>: error calling include: template: path/_uuu.tpl:90:45: executing "yyz.agentConfig" at <8>: wrong type for value; expected string; got []interface {}

错误原因 #

错误指向模板第8行（www: {{ .Values.a.www }}），说明.Values.a.www或.Values.a.rrr的类型是数组（[]interface{}），但Helm模板默认会将{{ }}中的值视为字符串输出，数组类型无法直接转换为字符串，导致类型不匹配。

同时你当前的写法存在冗余：先通过include渲染模板得到YAML字符串，再用fromYaml转成对象，最后又用toYaml转回字符串，多此一举的同时也放大了类型问题。

解决方案 #

方案1：直接渲染模板内容（推荐） #

去掉fromYaml和toYaml的冗余转换，直接将模板渲染结果嵌入ConfigMap：

修改configmap.yaml的data部分：

data:
  pqr.conf: |
    {{- include "yyz.agentConfig" . | nindent 4 }}

方案2：处理数组类型的Values字段 #

如果必须保留fromYaml转换逻辑，需要显式处理数组类型的字段：

• 若要输出YAML数组格式：使用toYaml并添加缩进
• 若要输出逗号分隔的字符串：使用join ","并包裹引号

修改_uuu.tpl中的数组字段：

{{- define "yyz.agentConfig" -}}
exporters:
  logs:
    uuu: {{ .Values.a.uuu | quote }}
    bnk: "${*****}"
    lqp: {{ .Values.a.lqp| quote }}
    qqq: {{ .Values.a.qqq | quote }}
    # 输出YAML数组格式
    www: {{ .Values.a.www | toYaml | nindent 6 }}
    # 输出逗号分隔的字符串（根据需求选择）
    # www: {{ .Values.a.www | join "," | quote }}
    rrr: {{ .Values.a.rrr | toYaml | nindent 6 }}
{{ end }}

验证 #

修改后执行helm template命令测试渲染结果，确认无类型错误，且ConfigMap内容符合预期。

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