Docker Compose部署PostgreSQL密码认证失败问题求助

这个问题我碰到过好多次了，核心原因其实和你的数据卷配置有关😉：PostgreSQL只有在首次启动、初始化数据目录的时候才会读取环境变量设置密码，而你配置了持久化数据卷~/docker/postgresql:/var/lib/postgresql/data——如果这个目录之前已经存在（比如你曾经启动过PostgreSQL容器，哪怕是用不同配置启动的），容器重启时会直接复用已有数据，完全跳过环境变量的初始化逻辑，导致你新设置的POSTGRES_PASSWORD根本没生效，认证自然失败。

快速解决方法（适合测试环境，数据可丢弃） #

1. 先停止并移除当前容器：

   docker-compose down
   

2. 删除已存在的PostgreSQL数据目录，彻底清除旧的初始化数据：

   rm -rf ~/docker/postgresql
   

3. 重新启动容器，这次PostgreSQL会重新初始化，读取你设置的环境变量密码：

   docker-compose up -d
   

保留数据的解决方法（适合生产环境） #

如果你不想丢失已有数据，需要进入容器内部手动修改postgres用户的密码：

1. 找到PostgreSQL容器的ID或名称：

   docker ps | grep postgresql
   

2. 进入容器的bash终端：

   docker exec -it <你的容器ID或名称> bash
   

3. 切换到postgres用户并登录数据库：

   su - postgres
   psql
   

4. 执行SQL命令修改密码（把00000000换成你需要的密码）：

   ALTER USER postgres PASSWORD '00000000';
   

5. 依次输入\q退出psql、exit退出容器，之后就可以用新密码登录了。

后续注意事项 #

• 以后如果要修改PostgreSQL密码，仅修改docker-compose里的环境变量是没用的，因为数据卷已经存在初始化数据，必须通过容器内修改密码的方式操作。
• 测试环境下如果频繁调整配置，建议暂时关闭数据卷持久化，或者每次修改后清理数据目录，避免旧数据干扰。

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