如何修复Helm安装时fullnameOverride空指针评估失败问题

问题根源 #

错误的核心是range循环内部上下文丢失：

• 执行{{- range .Values.persistentVolume.localStorage }}后，循环内部的.指向数组中的单个localStorage配置项，不再是Chart的根上下文。
• 调用include "mychart-stack.fullname"时默认传递当前上下文.，但该上下文无.Values字段，导致_helpers.tpl中访问.Values.fullnameOverride触发nil pointer错误。
• 循环内的{{ .Values.persistentVolume.basePath }}和{{ .Values.hostName }}同样错误，因为当前.无法访问全局Values配置。

修复方案 #

1. 显式传递根上下文到include：Helm中用$表示根上下文，调用include时需传入$，确保_helpers.tpl能访问全局.Values。
2. 修正循环内的Values引用：将循环内的.Values替换为$.Values，保证访问的是全局配置项。

修改后的模板代码 #

{{- range .Values.persistentVolume.localStorage }}
---
apiVersion: v1
kind: PersistentVolume
metadata:
  name: pv-{{ include "mychart-stack.fullname" $ }}-{{ .name }}
spec:
  capacity:
    storage: 20Gi
  # le champ volumeMode requiert l'activation de la "feature gate" Alpha BlockVolume
  volumeMode: Filesystem
  accessModes:
  - ReadWriteOnce
  persistentVolumeReclaimPolicy: Retain
  storageClassName: local-storage-{{ include "mychart-stack.fullname" $ }}--{{ .name }}
  local:
    path: {{ $.Values.persistentVolume.basePath }}/{{ .name }}
  nodeAffinity:
    required:
      nodeSelectorTerms:
      - matchExpressions:
        - key: kubernetes.io/hostname
          operator: In
          values:
          - {{ $.Values.hostName }}
{{- end }}

验证 #

修改后重新执行原命令：

helm install --dry-run -f "mychart-stack/values.yaml" mychart-stack1 ./mychart-stack

模板将正常渲染，不再出现nil pointer错误。

内容的提问来源于stack exchange，提问作者Micaël Félix