Wildfly10部署报错：NoClassDefFoundError: ProcessingException（PicketLink）

我之前在Wildfly环境下处理过类似的类加载问题，咱们一步步来排查和解决：

1. 确认jboss-deployment-structure.xml的模块引用是否准确 #

你提到WAR里配置了引用org.picketlink和org.picketlink.common模块，但要确保配置的位置和格式完全正确。如果你的WAR是嵌套在EAR里的，需要在EAR的jboss-deployment-structure.xml的<sub-deployment name="你的WAR包名.war">节点下添加依赖，而不是只在EAR的根节点里配置。正确的示例配置应该是：

<jboss-deployment-structure>
    <sub-deployment name="your-app.war">
        <dependencies>
            <module name="org.picketlink" />
            <module name="org.picketlink.common" />
        </dependencies>
    </sub-deployment>
</jboss-deployment-structure>

如果是独立WAR，直接在<deployment>节点下添加这两个模块依赖即可。

2. 排查EAR Manifest配置与WAR类加载的冲突 #

你说EAR的Manifest配置了org.picketlink依赖来解决之前的类找不到问题，但这可能和WAR的jboss-deployment-structure配置产生冲突——Wildfly中jboss-deployment-structure.xml的优先级高于Manifest配置。建议先暂时注释掉EAR Manifest里的PicketLink依赖，只保留WAR中的jboss-deployment-structure配置，重新部署测试是否还出现错误。

3. 验证Wildfly内置PicketLink模块的完整性 #

去你的Wildfly安装目录下的modules/org/picketlink/common/main路径，检查：

• module.xml是否正确引用了picketlink-common-2.7.0.Final.jar
• 打开这个jar包，确认里面确实存在org.picketlink.common.exceptions.ProcessingException类
  如果jar包缺失或者模块配置有误，会直接导致类加载失败。

4. 检查WAR包是否意外打包了PicketLink依赖 #

虽然你在POM里把PicketLink的依赖scope设为provided，但有时候Maven的依赖传递可能会偷偷把相关jar包打包到WAR的WEB-INF/lib下。如果出现这种情况，自定义类会优先加载WEB-INF/lib里的类，和Wildfly内置模块的类产生冲突，导致找不到特定类。
你可以解压WAR包检查WEB-INF/lib目录，要是有PicketLink相关的jar，就在POM里显式排除这些传递依赖：

<dependency>
    <!-- 你的其他依赖 -->
    <exclusions>
        <exclusion>
            <groupId>org.picketlink</groupId>
            <artifactId>picketlink-api</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.picketlink</groupId>
            <artifactId>picketlink-common</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.picketlink</groupId>
            <artifactId>picketlink-federation</artifactId>
        </exclusion>
    </exclusions>
</dependency>

5. 强制指定模块的包导入 #

如果上面的方法都没用，可以尝试在jboss-deployment-structure.xml里显式指定导入org.picketlink.common模块下的异常包，确保类加载器能正确加载到这个类：

<jboss-deployment-structure>
    <sub-deployment name="your-app.war">
        <dependencies>
            <module name="org.picketlink" />
            <module name="org.picketlink.common">
                <imports>
                    <include path="org/picketlink/common/exceptions/**" />
                </imports>
            </module>
        </dependencies>
    </sub-deployment>
</jboss-deployment-structure>

先从第1、4步开始排查，这两个是最常见的原因，应该能解决大部分情况。

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