Helm Chart安装ingress.yaml报nil pointer空指针错误

这个nil指针报错本质是模板渲染阶段读取不到.Values.ingress.annotations配置，和你有没有写class字段无关，由两个问题导致：

• values.yaml缩进不符合YAML解析规范：你贴的配置里ingress顶级键下的name/annotations/hosts等子字段前有6个空格的冗余缩进，YAML解析器对缩进敏感度极高，这种不规范缩进会直接导致层级识别错误，把annotations判定为非ingress下的字段，最终读值为空。
• 模板没有做缺省容错：模板里直接硬引用{{ .Values.ingress.annotations.class }}，没有配置默认值逻辑，只要上游读值为空就会直接抛出渲染错误，不会做降级处理。

1. 先修正values.yaml的缩进，统一用2个空格作为子级缩进，保证层级关系正确：

ingress:
  name: ingress-service
  replicaCount: 1
  annotations: 
    class: nginx
  hosts:
    - host: chart-example.local
      paths: 
        - path: /
          backend:
            service:
              name: ServiceName
              port:
                number: 8080

2. 优化模板的注解引用逻辑，增加容错，两种常用写法可选：
   • 给class字段加默认值，适合注解配置固定的场景：

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: {{ .Values.ingress.name }}
     annotations:
       kubernetes.io/ingress.class: {{ .Values.ingress.annotations.class | default "nginx" }}
   spec:
     rules:
     {{- range .Values.ingress.hosts }}
       - host: {{ .host | quote }}
         http:
           paths:
           {{- range .paths }}
             - path: {{ .path }}
               pathType: Prefix
               backend:
                 service:
                    name: {{ .backend.service.name }}
                    port:
                       number: {{ .backend.service.port.number }}
           {{- end }}
     {{- end }}
   

   • 直接遍历annotations配置生成注解块，灵活性更高，后续新增注解不需要修改模板：

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: {{ .Values.ingress.name }}
     annotations:
       {{- toYaml .Values.ingress.annotations | nindent 4 }}
   spec:
     rules:
     {{- range .Values.ingress.hosts }}
       - host: {{ .host | quote }}
         http:
           paths:
           {{- range .paths }}
             - path: {{ .path }}
               pathType: Prefix
               backend:
                 service:
                    name: {{ .backend.service.name }}
                    port:
                       number: {{ .backend.service.port.number }}
           {{- end }}
     {{- end }}
   

修改完成后先执行helm template 本地测试包名 ./你的chart目录做本地渲染校验，没有报错再执行安装即可。

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