Quarkus连接PostgreSQL构建报错：找不到对应JDBC驱动

1. 确认Gradle依赖配置正确 #

不要直接引入原生PostgreSQL JDBC驱动，必须使用Quarkus官方提供的quarkus-jdbc-postgresql扩展，该扩展会自动处理驱动的加载和集成。正确的Gradle依赖配置应为：

implementation 'io.quarkus:quarkus-jdbc-postgresql'

• 避免使用runtimeOnly范围，否则构建阶段无法获取驱动类，导致无法识别数据库类型。
• 执行./gradlew build --refresh-dependencies强制刷新依赖，确保扩展已正确下载到本地仓库。

2. 检查application.properties配置是否准确 #

确保数据源核心配置无拼写错误：

# 必须明确指定数据库类型为postgresql
quarkus.datasource.db-kind=postgresql
quarkus.datasource.jdbc.url=jdbc:postgresql://localhost:5432/你的数据库名
quarkus.datasource.username=你的用户名
quarkus.datasource.password=你的密码

• 注意db-kind的值是postgresql（完整拼写），不要写成postgres或其他缩写。
• 若配置了多数据源，需为每个数据源单独指定db-kind，避免冲突。

3. 排查DataSource注入与初始化逻辑 #

• 优先使用Quarkus提供的AgroalDataSource而非原生javax.sql.DataSource，确保与Quarkus的数据源管理体系兼容：

import io.agroal.api.AgroalDataSource;
import jakarta.inject.Inject;

public class YourDbService {
    @Inject
    AgroalDataSource dataSource;

    // 初始化逻辑避免在构建阶段触发（如@PostConstruct中不要执行数据库连接操作）
}

• 若必须在构建阶段执行数据库操作，可临时添加Class.forName("org.postgresql.Driver")显式加载驱动类（仅作排查用，不推荐长期使用）。

4. 检查构建环境与插件配置 #

• 确认Gradle的Quarkus插件版本与quarkus-jdbc-postgresql扩展版本一致，避免版本不兼容。
• 若使用Quarkus原生构建，需确保扩展已被正确包含在原生镜像中，可通过./gradlew quarkusBuild --native构建时查看日志，确认quarkus-jdbc-postgresql被列为已加载的扩展。

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