如何避免未定义Values时Helm的range块遍历空映射？

问题原因 #

Helm 会把未在values中定义的键视为空映射(map)，而非空列表(list)。当你用range遍历空映射时，模板会尝试解析内部的.name字段，但此时迭代的是映射的键值对（无有效内容），自然会报找不到字段的错误。而显式设置authorizationPolicies: []时，它是真正的空列表，range会直接跳过执行。

三种可行解决办法 #

1. 给values设置默认空列表 #

在你的chart的values.yaml中显式添加默认值：

# values.yaml
authorizationPolicies: []

这样无论用户是否自定义这个字段，Helm都会把它当作列表处理，未自定义时就是空列表，range块不会执行，避免报错。

2. 在模板中用default函数指定默认值 #

直接在range语句里给目标字段设置默认空列表，无需修改values.yaml：

{{- range (default .Values.authorizationPolicies []) -}}
apiVersion: security.istio.io/v1beta1
kind: AuthorizationPolicy
metadata:
  name: {{ .name }}-authorization-policy
... 
{{- end -}}

default函数会判断.Values.authorizationPolicies是否为nil（未定义），若是则用[]（空列表）替代，这样range遍历的始终是列表类型。

3. 先判断类型再遍历 #

用Helm的kindIs函数先检查字段类型，确认是列表后再执行range：

{{- if kindIs "slice" .Values.authorizationPolicies -}}
{{- range .Values.authorizationPolicies -}}
apiVersion: security.istio.io/v1beta1
kind: AuthorizationPolicy
metadata:
  name: {{ .name }}-authorization-policy
... 
{{- end -}}
{{- end -}}

kindIs "slice"会验证目标字段是否为列表类型，只有符合条件时才进入range块，避免遍历空映射的情况。

内容的提问来源于stack exchange，提问作者Victor Hugo Montes