Helm Chart配置Ingress模板时变量渲染为空的语法问题排查

渲染为空是两个低级错误共同导致的：

• YAML缩进不匹配：你写的内层paths列表项多缩进了2个空格，YAML是缩进敏感格式，缩进错位时Helm无法识别对应内容为paths的子元素，会直接丢弃这部分块，最终渲染出来paths字段后面是空的。
• 模板作用域传参错误：Helm的range循环会重置当前作用域.，你在内层循环里调用include "testapi.service.name" .和include "testapi.deployment.ports" .时，传入的.是当前遍历到的单条path配置对象，不是Chart的全局根上下文，自定义helper模板拿不到服务名、端口定义等全局配置，返回值为空。

直接替换templates/ingress.yaml里的spec段为以下内容即可：

spec:
  rules:
  {{- range .Values.ingress.spec.rules }}
  - host: {{ .host | quote }}
    http:
      paths:
      {{- range .paths }}
      - path: {{ .path | quote }}
        pathType: {{ .pathType | quote }}
        backend:
          service:
            # 传入全局根上下文$，而非当前path的局部作用域
            name: {{ include "testapi.service.name" $ }}
            port:
            {{- range $key, $value := (include "testapi.deployment.ports" $ | fromYaml) }}
              number: {{ .port }}
            {{- end }}
      {{- end }}
  {{- end }}

后续遇到Helm渲染为空、值不对的问题，直接执行带debug参数的命令定位具体错误，不需要靠猜：

helm template <你的release名> . --debug

命令会输出完整的渲染过程和语法报错的具体行号，定位效率高很多。

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