Helm模板传参检查Values.yaml字段存在性时遇$字符报错

问题根源 #

你的模板报错是因为两个核心问题：

1. 模板调用参数缺失：调用时只传了字段名字符串，导致模板内部无法访问原上下文里的.Values对象。
2. 非法模板语法：Go模板不支持在对象路径中直接嵌入变量（比如.Values.custom.$objectRef），$符号被识别为无效字符，必须用index函数实现动态字段访问。

修正方案 #

1. 修正模板定义 #

使用tuple传递上下文和字段名，并用index动态访问嵌套字段：

{{- define "example-name" -}}
{{- // 从传入的参数中拆分上下文和目标字段名 }}
{{- $ctx := index . 0 }}
{{- $objectRef := index . 1 }}
{{- // 动态获取Values.custom下的指定字段 }}
{{- $targetField := index $ctx.Values.custom $objectRef }}

{{- // 逐层检查字段是否存在 }}
{{- if $ctx.Values.custom }}
{{- if $targetField }}
{{- if $targetField.annotations }}
{{- include "some-library" (tuple $targetField.annotations) | indent 4 }}
{{- end }}
{{- end }}
{{- end }}
{{- end }}

2. 正确调用模板 #

调用时必须传递当前上下文和目标字段名组成的tuple，确保模板能访问到.Values：

{{- template "example-name" (tuple . "someField") }}

简化版（可选） #

可以用and合并多层条件判断，让代码更简洁：

{{- define "example-name" -}}
{{- $ctx := index . 0 }}
{{- $objectRef := index . 1 }}
{{- $targetField := index $ctx.Values.custom $objectRef }}

{{- // 一次性检查所有必要字段是否存在 }}
{{- if and $ctx.Values.custom $targetField $targetField.annotations }}
{{- include "some-library" (tuple $targetField.annotations) | indent 4 }}
{{- end }}
{{- end }}

关键知识点 #

• Helm模板的参数传递：如果需要同时传递上下文（包含.Values、.Release等）和自定义参数，必须用tuple打包。
• 动态字段访问：对于不确定键名的嵌套字段，必须使用index 父对象 键名的方式访问，不能直接在路径中嵌入变量。

内容的提问来源于stack exchange，提问作者mateusz.gorski123