Keycloak 24.0.X中resteasy-core是否缺失？嵌入启动异常求助

核心问题 #

升级Keycloak至24.0.X版本后遇到两个关键问题：

• 缺失jboss resteasy-core依赖，导致无法引用ResteasyContext类
• 手动添加该依赖后，应用启动后立即关闭，日志仅显示EntityManagerFactory和Hikari连接池的关闭信息

1. 正确适配Keycloak 24.X的依赖结构 #

Keycloak 24.X对依赖体系做了调整，原有resteasy相关依赖不再自动传递引入。不要单独手动添加resteasy-core，应通过Keycloak官方提供的BOM或starter来统一管理依赖，避免冲突：

Maven配置示例 #

在pom.xml中添加Keycloak BOM统一版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.keycloak</groupId>
            <artifactId>keycloak-bom</artifactId>
            <version>24.0.X</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

再引入嵌入式Keycloak核心依赖：

<dependencies>
    <dependency>
        <groupId>org.keycloak</groupId>
        <artifactId>keycloak-spring-boot-starter</artifactId>
    </dependency>
    <!-- 若需使用Resteasy相关API，添加此依赖 -->
    <dependency>
        <groupId>org.keycloak</groupId>
        <artifactId>keycloak-services</artifactId>
    </dependency>
</dependencies>

Gradle配置示例 #

dependencyManagement {
    imports {
        mavenBom "org.keycloak:keycloak-bom:24.0.X"
    }
}

dependencies {
    implementation 'org.keycloak:keycloak-spring-boot-starter'
    implementation 'org.keycloak:keycloak-services'
}

2. 排查应用启动即关闭的根源 #

手动添加resteasy-core会引发依赖冲突，这是启动失败的核心原因。调整依赖后，还需检查以下内容：

• 确保Spring Boot版本与Keycloak 24.X兼容（推荐Spring Boot 3.2+）
• 校验application.properties/application.yml中的Keycloak配置是否正确，示例配置：

keycloak.admin-user.username=admin
keycloak.admin-user.password=admin
keycloak.db.url=jdbc:h2:mem:keycloak
keycloak.db.driver=org.h2.Driver
keycloak.db.username=sa
keycloak.db.password=

• 查看完整启动日志（不要只关注关闭阶段），搜索ERROR/WARN级别的信息定位问题。可通过调整日志级别获取更多细节：

logging.level.org.keycloak=DEBUG
logging.level.org.springframework=DEBUG

3. 彻底清理并重新加载依赖 #

执行以下操作消除缓存依赖问题：

• 删除项目根目录下的target（Maven）或build（Gradle）文件夹
• 执行Maven命令：mvn clean install -U，或Gradle命令：gradle clean build --refresh-dependencies

重新启动应用即可正常加载Keycloak服务。

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