Spring Boot连接Docker部署PostgreSQL认证失败问题求助

1. 确认Docker端口映射有效性 #

检查PostgreSQL容器的端口映射是否将主机5432端口绑定到容器5432端口：

• 执行docker ps查看容器列表，确认PORTS列显示0.0.0.0:5432->5432/tcp或:::5432->5432/tcp
• 若映射异常，停止容器后重新启动，指定端口映射参数：docker run -p 5432:5432 ...

2. 验证Spring Boot配置加载准确性 #

确保应用读取的是预期的application.properties文件：

• 启动时查看日志，确认存在Loaded config file 'classpath:/application.properties'类日志
• 临时在代码中添加配置输出（仅测试使用）：

  @Value("${spring.datasource.password}")
  private String dbPassword;
  
  @PostConstruct
  public void printConfig() {
      System.out.println("Loaded DB Password: " + dbPassword);
  }
  

  启动后观察控制台输出的密码是否为admin

3. 排查JDBC驱动与PostgreSQL加密方式兼容性 #

Docker部署的PostgreSQL默认使用scram-sha-256加密算法，旧版JDBC驱动不支持该算法：

• 检查pom.xml（Maven）或build.gradle（Gradle）中的驱动版本，建议升级至42.2.20及以上：

  <dependency>
      <groupId>org.postgresql</groupId>
      <artifactId>postgresql</artifactId>
      <version>42.6.0</version>
  </dependency>
  

• 若无法升级驱动，可将PostgreSQL用户加密方式改为md5：
  1. 进入PostgreSQL容器：docker exec -it <容器ID> bash
  2. 登录PostgreSQL：psql -U postgres
  3. 执行修改命令：ALTER USER postgres WITH PASSWORD 'admin' ENCRYPTED WITH 'md5';
  4. 重启容器：docker restart <容器ID>

4. 确保pg_hba.conf修改生效 #

修改pg_hba.conf后必须重启PostgreSQL服务才能生效：

• 进入容器找到pg_hba.conf（通常在/var/lib/postgresql/data/目录），确认本地连接配置：

  host    all             all             127.0.0.1/32            scram-sha-256
  

• 修改后执行容器内重启命令：pg_ctl restart，或直接重启Docker容器
• 测试：在主机执行psql -h localhost -U postgres -d warehouse，输入密码admin验证是否能登录

5. 检查容器内PostgreSQL服务状态 #

验证容器内数据库服务是否正常：

• 进入容器后执行psql -U postgres -d warehouse，输入密码admin，确认能正常连接
• 若容器内连接失败，说明用户密码或数据库本身存在问题，需重置用户密码：ALTER USER postgres WITH PASSWORD 'admin';

内容的提问来源于stack exchange，提问作者Phú Huỳnh Gia