Helm安装Chart报错unable to build kubernetes objects如何解决

问题复现 #

执行安装命令：

helm install pt-sides-api --set env=dev,data_center_name=sl --set-string namespace="10475" -f values.yaml  --debug ./

返回报错：

Error: INSTALLATION FAILED: unable to build kubernetes objects from release manifest: unable to decode "": json: cannot unmarshal number into Go struct field ObjectMeta.metadata.namespace of type string
helm.go:84: [debug] unable to decode "": json: cannot unmarshal number into Go struct field ObjectMeta.metadata.namespace of type string
unable to build kubernetes objects from release manifest

尝试在values.yaml中配置namespace: !!string 10475后问题仍然存在。

根因说明 #

这个报错的核心原因是最终渲染生成的K8s Manifest里，metadata.namespace字段的值被YAML解析器识别为数字类型，而K8s API要求该字段必须为字符串类型。
之前尝试的--set-string传参、values里加!!string强转，只能保证Helm内部存储的这个值是字符串类型，但如果模板渲染时没有给这个值加引号包裹，纯数字内容输出到YAML文件后，会被YAML解析器自动判定为整数类型，最终触发类型不匹配错误。

排查思路 #

• 先执行模板渲染命令，导出最终生成的Manifest文件，直接定位问题点：

  helm template pt-sides-api --set env=dev,data_center_name=sl --set-string namespace="10475" -f values.yaml ./ > render_result.yaml
  

  打开导出的render_result.yaml，全局搜索namespace:字段，确认字段值是不是裸写的10475（没有引号包裹）。
• 检查Chart模板文件中所有引用.Values.namespace的位置，确认是否没有做字符串转义处理。
• 核对参数优先级：Helm参数生效优先级为--set/--set-string 传入参数 > -f指定的自定义values文件 > Chart自带的values.yaml，排查是否有其他高优先级配置覆盖了namespace值，传入了数字类型的内容。

解决方案 #

• 永久修复方案（推荐）：修改Chart模板，所有用到metadata.namespace的位置，用Helm内置的quote函数强制把值包裹为带引号的字符串，修改示例：

  metadata:
    namespace: {{ .Values.namespace | quote }}
  

  修改后重新执行渲染命令验证，生成的Manifest中namespace字段会变为namespace: "10475"，类型符合K8s要求，可正常安装。
• 临时修复方案（无需修改模板）：传参时手动给namespace值加一层转义引号，保证渲染后的值带引号，命令调整为：

  helm install pt-sides-api --set env=dev,data_center_name=sl --set-string namespace='"'10475'"' -f values.yaml  --debug ./
  

• 配置核对：检查values.yaml中namespace的配置路径和模板引用路径是否一致，比如如果模板引用的是.Values.global.namespace，顶层配置namespace: "10475"不会生效，需要在对应路径下配置字符串类型的值。

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