Java项目连接PostgreSQL提示postgres用户密码认证失败如何解决

密码修改影响说明 #

如果数据库对应用户的密码被修改，且没有同步更新Java项目数据源配置中的密码，必然会导致应用无法正常连接数据库，你遇到的password authentication failed for user "postgres"就是典型的密码校验失败错误。除了密码被修改的可能性外，你提供的配置本身存在多处不匹配问题，也会触发该报错或后续连接异常。

现有配置不匹配问题排查 #

• 端口配置错误 #

  docker-compose中PostgreSQL容器的端口映射规则为"5435:5432"，即宿主机侧需通过5435端口访问该数据库实例，但application.yml中的JDBC URL填写的端口为5432，此时应用连接的是服务器上5432端口的另一个PostgreSQL实例（而非你用docker启动的实例），该实例的postgres用户密码不是postgres，因此直接触发密码校验失败报错。

• 数据库名配置错误 #

  docker-compose中通过POSTGRES_DB指定初始化的数据库名为converter，但application.yml的JDBC URL中填写的库名为mark_convert，即使端口修正后也无法找到对应数据库。

• Liquibase Schema配置问题 #

  你提供的Liquibase配置中schemaName="history"是指定表创建在history模式下，并非指定库名。PostgreSQL不会自动创建不存在的模式，如果converter库下没有提前创建history模式，后续Liquibase执行时会抛出模式不存在的错误，和库名不一致的困惑没有关联。

修复步骤 #

1. 修正application.yml中的数据源配置，修改端口和库名和docker-compose配置对齐：

spring:
  datasource:
    url: jdbc:postgresql://localhost:5435/converter
    jdbc-url: jdbc:postgresql://localhost:5435/converter

2. 处理Liquibase的Schema配置：
   • 方案1：在Liquibase的建表变更集之前，新增创建history模式的SQL语句
   • 方案2：删除<createTable>标签中的schemaName="history"属性，表默认创建在PostgreSQL自带的public模式下
3. 验证密码有效性：
   配置修正后如果仍报密码错误，可直接用数据库客户端工具，使用账号postgres、密码postgres连接地址localhost:5435的converter库验证连通性，如果无法连通说明docker内的数据库密码确实被修改，可进入容器修改密码或删除挂载的数据库卷重新初始化（注意提前备份数据）。

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