Helm使用values.yaml值替换ConfigMap变量时报类型求值错误

报错核心是模板取值的层级顺序写反，触发了类型不匹配：

1. 对照values.yaml的结构：.Values.ports.app是数组（列表）类型，数组里的每个元素才是包含port、name字段的键值对对象，app列表本身没有直接的port属性。
2. 你写的{{ (first .Values.ports.app.port) }}执行逻辑是：先尝试取.Values.ports.app下的port字段——因为app是列表，不存在这个顶层字段，Helm在这里拿到的是无明确类型的interface{}空值，后续再对这个非法值执行first取首元素、访问Port属性的操作，就会抛出对应的类型错误。

根据实际取值场景，对应写法如下：

• 场景1：取app列表第一个端口（即8080的http端口）
  注意括号优先级：先用first拿到数组的第一个元素对象，再访问对象的port字段：

  variable: {{ (first .Values.ports.app).port }}
  

• 场景2：按端口名取指定端口（比如取name为admin的9090端口，避免硬编码数组索引）
  先用where过滤出对应name的端口列表，取第一个匹配项后再访问port字段：

  variable: {{ (index (where .Values.ports.app "name" "admin") 0).port }}
  

• 场景3：遍历所有app端口批量生成配置
  用range遍历数组逐个取值即可：

  {{- range .Values.ports.app }}
  port_{{ .name }}: {{ .port }}
  {{- end }}
  

注意：所有列表类型的取值，都要先执行列表操作（取首元素、按索引取值、过滤、遍历）拿到具体的元素对象后，再访问对象下的自定义字段，顺序颠倒就会触发类型错误。

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