Spring Boot连接PostgreSQL失败，日志显示驱动等参数异常求助

我正在学习Spring Boot，开发一个基于PostgreSQL的简单API应用，但无法建立有效JDBC连接，启动时没有出现连接成功提示，也无法自动创建表。环境是Mac，通过postgres.app安装PostgreSQL。

日志信息 #

Database JDBC URL [Connecting through datasource 'HikariDataSource (HikariPool-1)']
    Database driver: undefined/unknown
    Database version: 17.2
    Autocommit mode: undefined/unknown
    Isolation level: undefined/unknown
    Minimum pool size: undefined/unknown
    Maximum pool size: undefined/unknown

application.properties配置 #

spring.application.name=amigoscode-demo
spring.datasource.url=jdbc:postgresql://localhost:5432/student
spring.datasource.username=becky
spring.datasource.password=
spring.jpa.hibernate.dll-auto=create-drop
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
spring.jpa.properties.hibernate.format_sql=true
spring.jpa.generate-ddl = true

pom.xml配置 #

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.4.1</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>amigoscode-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>amigoscode-demo</name>
    <description>Demo project for Spring Boot Using https://www.youtube.com/watch?v=9SGDpanrc8U&amp;t=424s</description>
    <url/>
    <licenses>
        <license/>
    </licenses>
    <developers>
        <developer/>
    </developers>
    <scm>
        <connection/>
        <developerConnection/>
        <tag/>
        <url/>
    </scm>
    <properties>
        <java.version>17</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.postgresql</groupId>
            <artifactId>postgresql</artifactId>
            <version>42.7.4</version>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

已尝试的操作 #

• PostgreSQL服务器无密码，已确认可无密码访问；
• 添加Hikari连接池配置参数后无变化：

  spring.datasource.hikari.maximum-pool-size=10
  spring.datasource.hikari.minimum-idle=5
  spring.datasource.hikari.connection-timeout=30000
  spring.datasource.hikari.idle-timeout=600000
  spring.datasource.hikari.max-lifetime=1800000
  

• 执行mvn dependency:tree验证依赖，显示PostgreSQL依赖已存在；
• 执行pg_isready -d postgresql://localhost:5432/student确认本地可接受连接。

排查与解决方案 #

1. 修正Hibernate自动建表配置的拼写错误 #

你的application.properties中存在关键拼写错误：spring.jpa.hibernate.dll-auto=create-drop，正确参数应为ddl-auto（Data Definition Language，数据定义语言），而非dll-auto（动态链接库）。这个错误会直接导致Hibernate无法执行自动建表逻辑，同时可能干扰连接初始化的日志输出。

修改为：

spring.jpa.hibernate.ddl-auto=create-drop

2. 显式指定PostgreSQL驱动类 #

虽然Spring Boot通常能自动识别JDBC驱动，但显式指定驱动类可以避免加载异常：

spring.datasource.driver-class-name=org.postgresql.Driver

3. 更新Hibernate Dialect匹配PostgreSQL 17.2版本 #

日志显示数据库版本为17.2，当前配置的org.hibernate.dialect.PostgreSQLDialect是通用方言，建议使用适配PostgreSQL 17的专用方言，确保兼容性：

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQL17Dialect

4. 优化空密码配置 #

虽然已确认无密码访问，但空密码的配置可调整为以下两种方式之一，避免解析问题：

• 直接移除spring.datasource.password配置项；
• 设置为spring.datasource.password=""（空字符串）。

5. 让Spring Boot管理PostgreSQL驱动版本 #

当前pom.xml中手动指定了PostgreSQL驱动版本，可移除<version>标签，让Spring Boot parent自动匹配兼容版本：

<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <scope>runtime</scope>
</dependency>

6. 启用详细连接日志排查 #

在application.properties中添加日志配置，查看连接池初始化的详细过程：

logging.level.com.zaxxer.hikari=DEBUG
logging.level.org.hibernate.engine.jdbc.env.internal=DEBUG

启动应用后，通过DEBUG日志确认驱动是否加载、连接尝试是否执行、是否存在具体错误信息。

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