使用Helm与Kubernetes Secret配置Postgres连接字符串异常排查

这个错误是Go语言格式化字符串类型不匹配导致的——Helm使用Go的text/template模板引擎，当你构造连接字符串时，端口值是int64数字类型，但你用了需要字符串的方式处理（比如直接和字符串拼接、或用%s格式符格式化），就会出现%!s(int64=5432)这类类型转换失败的提示。

常见错误场景及修复方法 #

场景1：模板中用%s格式化数字端口

如果你的Helm模板是这样写的：

# templates/secret.yaml 中的片段
data:
  DB_CONNECTION_STRING: {{ b64enc (printf "host=%s port=%s user=%s dbname=%s password=%s" .Values.db.host .Values.db.port .Values.db.user .Values.db.name .Values.db.password) }}

这里用%s格式化数字类型的.Values.db.port，就会触发错误。

修复： 把端口对应的格式符改成%d（匹配数字类型）：

DB_CONNECTION_STRING: {{ b64enc (printf "host=%s port=%d user=%s dbname=%s password=%s" .Values.db.host .Values.db.port .Values.db.user .Values.db.name .Values.db.password) }}

场景2：模板中直接拼接数字端口与字符串

如果模板是直接拼接字符串：

DB_CONNECTION_STRING: {{ b64enc ("host=" + .Values.db.host + " port=" + .Values.db.port + " user=" + .Values.db.user) }}

数字类型的端口无法直接和字符串拼接，导致类型错误。

修复： 用toString函数把端口转成字符串：

DB_CONNECTION_STRING: {{ b64enc ("host=" + .Values.db.host + " port=" + (toString .Values.db.port) + " user=" + .Values.db.user) }}

场景3：Values文件中端口为数字类型

如果你的values.yaml里端口是数字：

db:
  port: 5432

也可以直接把端口改成字符串类型，避免模板中的类型转换问题：

db:
  port: "5432"

验证方法 #

修改模板或values文件后，重新执行Helm部署命令：

helm upgrade --install <release-name> <chart-path> -f values.yaml

部署完成后，通过Azure门户或kubectl get secret <secret-name> -o yaml查看Secret值，确认端口显示为正常的5432即可。

内容的提问来源于stack exchange，提问作者Salvatore Calla'