Kubernetes中通过Secret配置PostgreSQL角色名末尾带+的异常问题

核心原因 #

这个问题的本质是Kubernetes Secret/ConfigMap中存储的环境变量值末尾带有隐藏的换行符。

当通过以下方式创建Secret/ConfigMap时，极易引入换行符：

• 使用kubectl create secret generic的--from-literal参数时，输入值后不小心触发了换行；
• 通过--from-file导入变量时，源文件末尾存在换行；
• 编写YAML定义时，使用多行字符串格式（|或>）却未处理换行，或者base64编码时包含了换行符（比如用echo "letschurch" | base64而非echo -n "letschurch" | base64）。

PostgreSQL初始化脚本读取POSTGRES_USER变量时，会将末尾的换行符视为角色名的一部分。而Shell环境中用echo $POSTGRES_USER查看时，换行符会被输出为空白，导致你误以为变量值正常，但实际传入PostgreSQL的是带换行的角色名（终端中可能显示为letschurch+）。

而docker-compose中直接定义POSTGRES_USER: letschurch时，不会引入额外换行符，因此角色名正常。

验证步骤 #

1. 进入容器执行printf "%q" $POSTGRES_USER，若输出为letschurch$'\n'，则确认变量带换行符；
2. 解码Secret值：执行kubectl get secret postgres-secret -o jsonpath='{.data.POSTGRES_USER}' | base64 -d | cat -A，若末尾显示$（换行符标识），即可坐实问题。

解决方法 #

1. 重新创建Secret/ConfigMap：
   • 使用--from-literal时确保值末尾无换行：

     kubectl create secret generic postgres-secret --from-literal=POSTGRES_USER=letschurch --from-literal=POSTGRES_PASSWORD=your-password
     

   • 若用文件导入，先清理文件末尾换行：tr -d '\n' < user.txt > user-clean.txt，再用--from-file=POSTGRES_USER=user-clean.txt导入。
2. 修正YAML定义：
   若用YAML编写Secret，确保base64编码不含换行符——用echo -n "letschurch" | base64生成正确编码（-n参数会去掉echo默认添加的换行），替换YAML中对应的data字段值。

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