You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Helm升级ConfigMap引用values.yaml值报数字类型错误问题

问题根因

Kubernetes 规定 ConfigMap 资源的 data 字段下所有值必须为字符串类型。
你在 values.yaml 中配置的 httpport: 4442 是未加引号的纯数字格式,Helm 渲染模板时会自动按照 YAML 类型规则将其识别为整数类型,最终渲染出的 ConfigMap 中 server.http.port 对应的值是数字 4442,而非字符串 "4442"。
helm template 命令仅负责输出渲染后的 YAML 文本,不会对接 Kubernetes API 做资源类型校验,因此执行时不会报错;但执行 helm upgrade 时,渲染后的资源会提交给集群 API Server,类型校验不通过就会抛出 json: cannot unmarshal number into Go struct field ConfigMap.data of type string 的错误。

修复方案

任选以下一种方式修改即可:

  • 模板侧强制转字符串(推荐,无需调整values定义,适配性更强)
    修改 configMap.yaml 中的字段引用,使用 Helm 内置的 quote 函数把值强制包裹为字符串,或者直接给模板表达式加双引号:
    # 方式1:使用quote函数,自动处理特殊字符转义
    server.http.port: {{ .Values.httpport | quote }}
    
    # 方式2:直接加双引号包裹
    server.http.port: "{{ .Values.httpport }}"
    
  • values侧直接定义为字符串
    修改 values.yaml 中对应字段的值,给数字加引号,让Helm一开始就把它识别为字符串类型:
    httpport: "4442"
    

提示:不止端口值,所有ConfigMap、Secret的data字段下的配置,只要是纯数字、布尔值(true/false)、浮点数这类会被YAML自动解析为非字符串类型的内容,都需要做字符串转换,否则都会触发同类类型校验错误。

内容的提问来源于stack exchange,提问作者Tamar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.28 09:06:18