Keycloak 22.0.5中admin-client遇RESTEasy Jakarta Form错误求助

错误原因解析 #

你遇到的RESTEASY003215: could not find writer for content-type application/x-www-form-urlencoded type: jakarta.ws.rs.core.Form$1错误，本质是：

• RESTEasy缺少能将jakarta.ws.rs.core.Form（及其内部类实例）序列化为表单编码格式的MessageBodyWriter提供者
• Maven Shade插件合并SPI配置时，使用了旧的javax命名空间路径，导致Jakarta EE环境下无法加载正确的提供者

具体解决方案 #

1. 添加表单处理依赖 #

在pom.xml的<dependencies>中加入RESTEasy的表单提供者依赖，这是处理application/x-www-form-urlencoded格式的核心依赖：

<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-form-provider</artifactId>
    <version>${resteasy.version}</version>
</dependency>

2. 修正Maven Shade插件的SPI路径 #

你的Shade插件配置中，合并的Providers文件路径还是旧的javax命名空间，需要替换为Jakarta版本的路径：
将原来的：

<transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
    <resource>META-INF/services/javax.ws.rs.ext.Providers</resource>
</transformer>

修改为：

<transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
    <resource>META-INF/services/jakarta.ws.rs.ext.Providers</resource>
</transformer>

Keycloak 22基于Jakarta EE，所有JAX-RS相关的SPI都迁移到了jakarta命名空间，旧路径无法被加载，这是导致找不到Writer的关键原因之一。

3. 优化Form对象构建（可选） #

虽然不是直接诱因，但建议避免直接通过MultivaluedMap构造Form，改用Form的原生API构建实例，减少内部类相关的潜在问题：

Form authForm = new Form()
    .param("username", "your-admin-user")
    .param("password", "your-admin-pass")
    .param("grant_type", "password");

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