Spring JPA执行mvn test时无法连接指定PostgreSQL数据库求助

问题现象 #

Spring JPA应用执行mvn test时抛出错误：org.postgresql.util.PSQLException: FATAL: database "wds_fin" does not exist，但通过pgAdmin和IntelliJ数据库浏览器可正常连接wds_fin、amigoscode和postgres三个数据库（均归postgres用户所有且权限完整）。仅当将JDBC URL改为jdbc:postgresql://localhost:5432/postgres时测试可正常运行。

测试环境配置（test/resources/application.properties）：

spring.datasource.url=jdbc:postgresql://localhost:5432/wds_fin
spring.datasource.username=postgres
spring.datasource.password=password

可能的原因及解决方法 #

1. 测试配置被覆盖 #

Spring Boot测试阶段会优先加载特定配置文件或外部参数，可能覆盖了application.properties中的数据源配置。

• 排查步骤：
  • 检查测试目录下是否存在application-test.properties/application-test.yml，确认其中的spring.datasource.url是否正确。
  • 执行mvn test -Ddebug，查看日志中实际生效的数据源URL是否为目标数据库地址。
  • 检查系统环境变量（如SPRING_DATASOURCE_URL）或启动参数是否注入了错误的配置值。

2. PostgreSQL认证规则限制 #

PostgreSQL的pg_hba.conf文件可能对不同数据库设置了差异化的连接认证规则，导致连接wds_fin等库时被拒，驱动将错误封装为"数据库不存在"。

• 解决步骤：
  • 找到PostgreSQL的pg_hba.conf文件（通常位于数据存储目录下）。
  • 确保localhost连接规则允许postgres用户访问所有数据库，示例配置：

    host    all             postgres        127.0.0.1/32            md5
    host    all             postgres        ::1/128                 md5
    

  • 修改后重启PostgreSQL服务，重新执行测试。

3. JDBC驱动兼容性或格式问题 #

旧版本JDBC驱动可能存在兼容性问题，或数据库名称的特殊格式（如创建时使用双引号）导致识别错误。

• 解决步骤：
  • 如果创建数据库时使用了双引号包裹名称，在JDBC URL中添加引号：

    spring.datasource.url=jdbc:postgresql://localhost:5432/"wds_fin"
    

  • 更新PostgreSQL JDBC驱动到最新稳定版本，在pom.xml中修改：

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

4. 构建或连接池缓存问题 #

之前的构建缓存或连接池缓存可能保留了错误的连接信息。

• 解决步骤：
  • 执行mvn clean test，清除构建缓存后重新运行测试。
  • 在测试类中添加数据源初始化逻辑，确保每次测试都使用新的连接。

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