直接结论

模板已经输出文本,但生成结果不是有效 YAML;应查看报错行附近的最终渲染内容。

错误出现在哪里

Helm template 与 install

根本原因

常见原因包括 nindent 深度错误、{{- 过度裁剪空白、未加引号的冒号或条件分支留下不完整键。

最小复现

metadata:
  labels:
  {{- toYaml .Values.labels | nindent 2 }}

修正示例

metadata:
  labels:
{{ toYaml .Values.labels | nindent 4 }}

验证修复

把 helm template --debug 输出保存为文件,再用 YAML 校验器检查。

还需要检查

  • 错误行号通常对应渲染结果,不是源模板。
  • 先缩小到最小失败模板。

权威参考

版本相关行为请参考 Helm 模板调试