Helm部署Ingress报错：paths应为数组却获map，求定位问题

错误原因 #

你的Ingress模板存在两个关键语法问题，直接导致生成的YAML不符合Kubernetes networking.k8s.io/v1 API要求：

1. 结构缩进错误：http:块没有包含在range .Values.ingress.hosts的循环范围内，生成后的YAML里http会脱离每个host条目，变成rules数组的独立元素，结构完全混乱。
2. paths格式错误：paths下的规则没有以- 开头，导致paths被解析为map类型而非API要求的array类型，这正是报错的直接原因。

修复后的Ingress模板代码 #

{{- if .Values.ingress.enabled -}}
{{- $fullName := include "something.fullname" . -}}
{{- $servicePort := .Values.service.port -}}
{{- $ingressPath := .Values.ingress.path -}}
{{- if .Capabilities.APIVersions.Has "networking.k8s.io/v1" }}
apiVersion: networking.k8s.io/v1
{{- else if .Capabilities.APIVersions.Has "extensions/v1beta1" }}
apiVersion: extensions/v1beta1
{{- else }}
{{ fail "Unsupported API version"}}
{{- end }}
kind: Ingress
metadata:
  name: {{ $fullName }}
  labels:
    app.kubernetes.io/name: {{ .Chart.Name }}
    app.kubernetes.io/instance: {{ .Release.Name }}
    app.kubernetes.io/version: {{ .Chart.AppVersion }}
    app.kubernetes.io/component: {{ .Values.component }}
    app.kubernetes.io/part-of: {{ .Values.partof }}
    app.kubernetes.io/managed-by: {{ .Release.Service }}
    helm.sh/chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}

    {{- with .Values.labels.something}}
    {{ toYaml . }}
    {{- end }}
{{- with .Values.ingress.annotations }}
  annotations:
{{ toYaml . | indent 4 }}
{{- end }}
spec:
{{- if .Values.ingress.tls }}
  tls:
  {{- range .Values.ingress.tls }}
    - hosts:
      {{- range .hosts }}
        - {{ . }}
      {{- end }}
      secretName: {{ .secretName }}
  {{- end }}
{{- end }}
  rules:
  {{- range .Values.ingress.hosts }}
    - host: {{ . }}
      http:
        paths:
          {{- if $.Capabilities.APIVersions.Has "networking.k8s.io/v1" }}
          - pathType: Prefix
            path: {{ default "/" $.Values.ingress.path }}
            backend:
              service:
                name: {{ default $fullName $.Values.service.name }}
                port:
                  number: {{ $.Values.service.port }}
          {{- else if $.Capabilities.APIVersions.Has "extensions/v1beta1" }}
          - path: {{ default "/" $.Values.ingress.path }}
            backend:
              serviceName: {{ default $fullName $.Values.service.name }}
              servicePort: {{ $.Values.service.port }}
          {{- end }}
  {{- end }}
{{- end }}

关键修复点说明 #

• 把http:块移入range .Values.ingress.hosts循环内部，确保每个host条目对应完整的http规则。
• 在paths下的每条规则前添加- ，明确这是数组中的一个元素，符合API对array类型的要求。
• 补充path字段：networking.k8s.io/v1 API要求必须指定path，原模板遗漏了这个必填项，添加默认值/避免额外报错。
• 循环内部引用根上下文变量时用$.替代.（因为range循环内的.指向当前host元素，而非根Values）。

验证方法 #

修复后可以用以下命令提前渲染模板，检查生成的YAML结构是否正确：

helm template . --debug | grep -A20 "spec:"

确认生成的rules结构类似：

spec:
  rules:
    - host: example.com
      http:
        paths:
          - pathType: Prefix
            path: /
            backend:
              service:
                name: something-fullname
                port:
                  number: 80

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