WildFly10部署EAR时EJB模块报KeycloakPrincipal类找不到求助

看起来你的问题核心是：EJB模块（appEJB.jar）的类加载器无法获取Keycloak的API类——毕竟你现在只给WEB模块配置了Keycloak的secure-deployment，EJB模块没搭上这趟车。下面给你几个可行的配置方案，让EJB能隐式获取Keycloak库：

方案1：通过jboss-deployment-structure.xml显式导入Keycloak模块 #

这是最灵活的方式，只针对你的EJB模块添加依赖，不会影响其他部署。

在你的EAR包的META-INF目录下创建jboss-deployment-structure.xml文件，内容如下：

<jboss-deployment-structure>
    <sub-deployment name="appEJB.jar">
        <dependencies>
            <!-- 导入Keycloak核心适配器模块，解决KeycloakPrincipal找不到的问题 -->
            <module name="org.keycloak.keycloak-adapter-core" />
            <!-- 如果EJB中需要用到Servlet相关的Keycloak类，可添加下面的模块 -->
            <!-- <module name="org.keycloak.keycloak-servlet-adapter-core" /> -->
        </dependencies>
    </sub-deployment>
</jboss-deployment-structure>

这个文件会告诉WildFly的类加载器，让appEJB.jar模块依赖Keycloak的核心适配器模块，这样EJB里的类就能顺利找到org.keycloak.KeycloakPrincipal了。

方案2：为EJB模块配置Keycloak Secure Deployment #

虽然Keycloak的secure-deployment主要用于WEB应用，但你也可以为EJB模块添加配置，让WildFly自动为它关联Keycloak模块。

修改你的Keycloak子系统配置，添加针对appEJB.jar的secure-deployment：

<subsystem xmlns="urn:jboss:domain:keycloak:1.1">
    <secure-deployment name="appWEB.war">
        <realm>demo</realm>
        <resource>app</resource>
        <use-resource-role-mappings>true</use-resource-role-mappings>
        <public-client>true</public-client>
        <auth-server-url>http://localhost:8180/auth</auth-server-url>
        <ssl-required>EXTERNAL</ssl-required>
        <principal-attribute>preferred_username</principal-attribute>
    </secure-deployment>
    <!-- 新增EJB模块的secure-deployment配置 -->
    <secure-deployment name="appEJB.jar">
        <realm>demo</realm>
        <resource>app</resource>
        <use-resource-role-mappings>true</use-resource-role-mappings>
        <auth-server-url>http://localhost:8180/auth</auth-server-url>
        <ssl-required>EXTERNAL</ssl-required>
    </secure-deployment>
</subsystem>

注意EJB模块不需要public-client和principal-attribute这些WEB专属配置，只保留基础的realm、resource等配置即可。配置完成后，WildFly会自动为EJB模块添加Keycloak的依赖。

方案3：配置全局模块（不推荐，除非所有部署都需要） #

如果你的WildFly上所有部署都需要访问Keycloak的类，可以把Keycloak模块配置为全局模块。修改WildFly的standalone.xml或domain.xml中的EE子系统配置：

<subsystem xmlns="urn:jboss:domain:ee:4.0">
    <global-modules>
        <module name="org.keycloak.keycloak-adapter-core" slot="main"/>
    </global-modules>
    <!-- 其他EE子系统配置内容 -->
</subsystem>

这种方式会让所有部署（包括EJB、WAR等）都能访问Keycloak的核心类，但可能引入不必要的依赖，所以只在特殊场景下使用。

关于WFLYCTL0412错误 #

这个错误通常是WEB部署的依赖缺失导致的，当你解决了EJB模块的类依赖问题后，大概率会自动消失。如果仍存在，建议检查WEB模块的Keycloak配置是否正确（比如auth-server-url是否可访问，realm和resource名称是否和Keycloak服务器上的一致）。

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