Keycloak自定义事件集成Kafka报错：NoClassDefFoundError

出现java.lang.NoClassDefFoundError: org/apache/kafka/clients/producer/KafkaProducer的核心原因是你的扩展jar未包含Kafka客户端依赖，且Keycloak的类加载器无法从外部获取该依赖。Keycloak的扩展类加载机制是隔离的，默认不会自动加载第三方依赖，必须将所需依赖打包到扩展jar中。

以下是具体解决步骤：

1. 使用Maven Shade插件打包依赖到扩展jar #

修改pom.xml，添加maven-shade-plugin，它会将Kafka客户端的类合并到你的扩展jar中，确保Keycloak能找到这些类。

<build>
    <plugins>
        <!-- 保留原有编译等插件配置 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.5.3</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <mainClass><!-- 无需主类可留空 --></mainClass>
                            </transformer>
                        </transformers>
                        <artifactSet>
                            <includes>
                                <include>org.apache.kafka:kafka-clients</include>
                            </includes>
                        </artifactSet>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

2. 确认Kafka依赖范围为compile #

确保pom.xml中kafka-clients的依赖范围是compile（默认即为compile，不要改为provided）：

<dependency>
    <groupId>org.apache.kafka</groupId>
    <artifactId>kafka-clients</artifactId>
    <version>3.7.0</version>
    <!-- 不要添加<scope>provided</scope>，否则Maven不会打包该依赖 -->
</dependency>

3. 重新打包并验证 #

执行mvn clean package，生成的带-shaded后缀的jar文件会包含Kafka客户端的所有类。你可以解压该jar，检查是否存在org/apache/kafka/clients/producer/KafkaProducer.class文件，确认依赖已被打包。

4. Keycloak Quarkus版本的额外配置（可选） #

如果使用Keycloak 17+的Quarkus版本，除打包依赖外，还可在扩展jar的META-INF/keycloak-deployment.properties文件中添加类加载策略：

quarkus.class-loader.parent-first-artifacts=org.apache.kafka

此配置会让Keycloak优先从父类加载器加载Kafka相关类，但前提是Keycloak环境中已存在Kafka依赖，否则仍推荐使用打包依赖的方式。

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