Docker Secrets 无法与Postgres容器配合使用问题求助

核心问题定位 #

从错误信息来看，Postgres使用默认postgres用户而非你通过Secrets配置的用户进行认证，说明Secrets文件内容未被正确读取，或数据库卷残留了旧的用户配置。

具体解决步骤 #

1. 检查Secrets文件的内容格式 #

Postgres读取*_FILE环境变量对应的文件时，会把文件内**所有内容（包括换行、空格、注释）**当作用户名/密码/数据库名的一部分。需确保你的秘密文件满足：

• 仅包含纯文本内容，无多余换行、空格或注释
• 例如：.db.user.env文件里只能写目标用户名（如usr），不能有其他字符

验证方法：进入Postgres容器查看秘密文件内容：

docker exec -it <postgres容器名> cat /run/secrets/db_user_env

若输出包含多余字符，修改本地对应文件并删除冗余内容。

2. 清理残留的数据库卷 #

如果之前用直接环境变量（POSTGRES_USER等）启动过Postgres，db-data卷会保留旧的用户和数据库配置。即使改用Secrets，Postgres不会重新初始化数据库，导致认证失败。

解决方法：

# 停止并移除容器
docker-compose down
# 删除数据卷（注意：此操作会清除所有数据库数据，需提前备份）
docker volume rm <你的项目名>_db-data
# 重新启动服务
docker-compose up -d

3. 验证Postgres容器初始化日志 #

启动后查看Postgres容器日志，确认是否正确读取Secrets配置：

docker logs <postgres容器名>

若日志中出现以下内容，说明Secrets配置生效：

PostgreSQL init process complete; ready for start up.
LOG:  database system is ready to accept connections

若仍显示使用默认postgres用户，回到步骤1重新检查文件内容。

4. 检查应用端的配置读取逻辑 #

应用中的DB_USER_ENV_FILE等环境变量，需确保代码是读取文件内容而非直接使用文件名作为用户名/密码。示例（Python）：

import os

with open(os.environ['DB_USER_ENV_FILE'], 'r') as f:
    db_user = f.read().strip()

若代码直接把/run/secrets/db_user_env当作用户名，会导致认证失败。

额外验证 #

在Postgres容器内尝试用Secrets中的用户连接，确认数据库端配置正常：

docker exec -it <postgres容器名> psql -U $(cat /run/secrets/db_user_env) -d $(cat /run/secrets/db_name_env)

若能成功连接，问题出在应用端的配置读取逻辑。

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