如何在Quarkus中完全禁用Agroal？

1. 定位依赖引入路径 #

先确认Agroal是直接还是间接引入的，通过构建工具查看依赖树：

• Maven：执行 mvn dependency:tree | grep agroal，找到触发Agroal引入的父依赖（通常是quarkus-jdbc-*、quarkus-hibernate-orm这类数据库相关扩展）
• Gradle：执行 ./gradlew dependencies | grep agroal

2. 排除间接依赖 #

如果是其他扩展间接引入的Agroal，在构建配置中明确排除：

Maven示例 #

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-jdbc-postgresql</artifactId> <!-- 替换为你实际使用的JDBC扩展 -->
    <exclusions>
        <exclusion>
            <groupId>io.quarkus</groupId>
            <artifactId>quarkus-agroal</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Gradle示例 #

implementation("io.quarkus:quarkus-jdbc-postgresql") { // 替换为你实际使用的JDBC扩展
    exclude group: 'io.quarkus', module: 'quarkus-agroal'
}

3. 强制禁用Agroal特性 #

若排除依赖后日志仍显示Agroal，在应用配置文件中强制关闭该特性：
application.properties 配置：

quarkus.agroal.enabled=false

application.yml 配置：

quarkus:
  agroal:
    enabled: false

4. 清理构建缓存并验证 #

执行构建清理命令，避免缓存残留旧依赖：

• Maven：mvn clean install
• Gradle：./gradlew clean build

重新启动应用，检查日志是否已移除agroal相关条目。

额外说明 #

如果你的应用依赖了quarkus-hibernate-orm这类ORM扩展，默认会绑定Agroal；若不需要数据库连接池，需直接移除这类ORM/JDBC扩展；若需要替换连接池，可引入其他实现（如HikariCP）并配置对应扩展替代Agroal。

内容的提问来源于stack exchange，提问作者Karl Kildén