Docker中PostgreSQL自定义凭据连接失败问题求助

问题原因 #

PostgreSQL Docker镜像的初始化逻辑是：第一次启动时如果数据目录为空，才会根据环境变量创建指定的用户、密码和数据库。你之前用默认凭据启动过容器，Docker卷database_data已经保存了当时初始化的数据库数据（包括旧用户app和密码!ChangeMe!），之后修改docker-compose.yml里的环境变量，容器启动时会直接复用卷里的旧数据，不会重新初始化，所以新凭据无效，旧凭据还能正常用。

解决步骤 #

1. 彻底清理旧容器和卷
   在项目文件夹下执行命令，停止容器并删除关联的数据卷：

   docker-compose down -v
   

   （-v参数会删除docker-compose.yml中定义的所有卷，这里就是database_data）

2. 重新启动容器
   用新的配置重新创建容器和数据库：

   docker-compose up -d
   

   这次启动时，因为卷已经被删除，PostgreSQL会重新读取docker-compose.yml里的新环境变量，创建用户test、密码123和数据库testdb。

3. 验证连接
   用新凭据连接数据库：

   psql -h localhost -p 5433 -U test -d testdb
   

   输入密码123就能正常连接了。

额外提示 #

如果不想丢失现有数据（比如已经有业务数据），不要直接删除卷，而是进入容器内部修改PostgreSQL的用户密码：

1. 进入运行中的容器：

   docker-compose exec database bash
   

2. 用旧用户登录PostgreSQL：

   psql -U app -d app
   

3. 修改用户密码或创建新用户：

   -- 修改现有用户密码
   ALTER USER test WITH PASSWORD '123';
   -- 或者创建新用户
   CREATE USER test WITH PASSWORD '123';
   GRANT ALL PRIVILEGES ON DATABASE testdb TO test;
   

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