Helm中用range遍历.Values生成租户专属MQTT主题列表报错解决

原始.Values配置：

mqtt:
  topics:
    - /tenant/+/#
    - /otherStuff/
    - /importantStuff/

tenants:
  - id: tenantA
    name: Tenant A
  - id: tenantB
    name: Tenant B

需求：替换通配符主题/tenant/+/#，生成租户专属的主题列表项：

• /tenant/tenantA/#
• /tenant/tenantB/#

尝试的写法（触发报错）：

mqtt:
  topics:
{{- range .Values.tenants }}
    - /tenant/{{ .id }}/#
{{ end }}
    - /otherStuff/
    - /importantStuff/

报错信息：

A block sequence may not be used as an implicit map key
Implicit keys need to be on a single line
Implicit map keys need to be followed by map values

问题根源是模板渲染后的YAML格式不合法，主要是多余空行或缩进错位导致YAML解析器误判结构。以下两种方法可以解决：

方法1：修正模板空白控制，保持原列表结构 #

在range的闭合标签{{ end }}前加上减号-，消除模板渲染产生的多余空行，确保列表项缩进完全对齐：

mqtt:
  topics:
{{- range .Values.tenants }}
    - /tenant/{{ .id }}/#
{{- end }}
    - /otherStuff/
    - /importantStuff/

{{- ... }}中的减号会移除标签前后的空白字符，保证输出的YAML是连续合法的列表结构。

方法2：用模板函数合并列表（更简洁） #

借助Helm的模板函数，先生成租户主题列表，再和固定主题合并后输出：

mqtt:
  topics:
{{- $fixed := list "/otherStuff/" "/importantStuff/" }}
{{- $tenantTopics := .Values.tenants | map (func(t) (print "/tenant/" t.id "/#")) }}
{{- $all := append $tenantTopics $fixed }}
{{- toYaml $all | nindent 4 }}

解释：

• $fixed定义固定主题的列表
• map函数遍历租户列表，用print拼接出每个租户的主题
• append合并两个列表，toYaml转成YAML格式，nindent 4设置正确的缩进（和topics下的列表项缩进一致）

关键注意点 #

YAML对缩进和空白极其敏感，Helm模板输出的内容必须严格符合YAML语法。如果模板渲染后出现空行、缩进不一致，就会触发类似你遇到的解析错误，所以一定要用{{- ... }}控制空白。

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