Docker部署SpringBoot连接PostgreSQL报role不存在问题排查

这个报错核心是你实际连接上的Postgres实例里确实不存在amigoscode角色，和你贴的当前配置写法无关，问题出在两个高频踩坑点：

• Postgres官方镜像仅在数据目录完全为空的首次启动阶段，才会读取POSTGRES_USER、POSTGRES_PASSWORD这类环境变量完成角色、库的初始化。你在compose里配置了postgres命名卷做数据持久化，如果之前启动过同名Postgres服务且没删除旧卷，后续哪怕修改了环境变量重启容器，Postgres会直接加载旧卷里的存量数据，完全不会执行新的用户初始化逻辑——你以为配置已经生效创建了目标用户，实际上卷里存的旧库根本没有这个角色。
• 如果你把SpringBoot应用也放在同一个docker-compose集群里以容器模式运行，当前配置里的jdbc:postgresql://localhost:5432/customer是错误的：容器内的localhost指向应用容器自身，如果你宿主机刚好有运行在5432端口的原生Postgres服务，应用会误连到宿主机的Postgres实例，这个实例里没有对应角色也会抛出一模一样的错误。

1. 先停掉当前所有相关容器，彻底删除旧的持久化卷（如果卷里有重要业务数据先提前备份）：

   docker-compose down -v
   

2. 根据SpringBoot应用的运行位置修正数据库连接配置：
   • 应用直接跑在宿主机（非Docker容器启动）：保留当前localhost的连接地址配置即可
   • 应用作为服务加入当前docker-compose集群、在Docker网络内运行：把连接地址里的localhost替换为Postgres的服务名postgres，对应配置修改为：

     url: jdbc:postgresql://postgres:5432/customer
     

3. 重新启动compose中的Postgres、pgAdmin服务：

   docker-compose up -d
   

4. 等待10-20秒待Postgres完全初始化完成（可以通过docker logs postgres查看日志确认启动状态），再启动SpringBoot应用即可。

如果操作后还是报错，可以直接进入Postgres容器校验角色是否真的创建成功：

# 进入容器内的psql命令行
docker exec -it postgres psql -U postgres

进入psql交互终端后执行\du命令，就能列出实例内所有存在的角色，如果列表里没有amigoscode，说明初始化流程未正常执行，重新执行删卷重启步骤即可。

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