EasyExcel在WebLogic 14.1.1中生成Excel失败的解决方案

在企业级Java应用开发中，使用Alibaba开源的EasyExcel库处理Excel文件是一种常见做法。然而，当我们将应用部署到WebLogic 14.1.1服务器时，可能会遇到生成Excel文件失败的问题，这通常是由于类加载冲突导致的。

问题现象

当在WebLogic 14.1.1环境中使用EasyExcel 4.0.3版本时，调用EasyExcel.write()方法生成Excel文件时，系统会抛出ClassCastException异常。异常堆栈显示org.apache.xmlbeans.impl.schema.SchemaTypeSystemImpl无法转换为org.apache.xmlbeans.SchemaTypeLoader，这表明存在类加载器冲突问题。

根本原因分析

WebLogic服务器自带了一些XML处理相关的库，特别是com.bea.core.xml.xmlbeans.jar，这个JAR包中包含了一些与Apache XMLBeans相关的类。当EasyExcel尝试使用Apache POI和XMLBeans处理Excel文件时，WebLogic的类加载器优先加载了服务器自带的版本，而不是应用内包含的版本，导致了类不兼容的问题。

解决方案

方案一：修改WebLogic配置（推荐）

1. 定位WebLogic安装目录下的wlserver/modules文件夹
2. 找到com.bea.core.xml.xmlbeans.jar文件
3. 将该文件重命名为com.bea.core.xml.xmlbeans.jar.bak
4. 重启WebLogic服务器

这种方法通过移除冲突的JAR包，强制WebLogic使用应用内包含的正确版本的XMLBeans库。

方案二：配置weblogic.xml（备选）

如果无法修改服务器配置，可以在应用的WEB-INF目录下创建或修改weblogic.xml文件，添加以下配置：

<wls:weblogic-web-app xmlns:wls="http://xmlns.oracle.com/weblogic/weblogic-web-app">
    <wls:container-descriptor>
        <wls:prefer-application-packages>
            <wls:package-name>org.apache.commons.io.*</wls:package-name>
            <wls:package-name>org.apache.poi.*</wls:package-name>
            <wls:package-name>org.apache.xmlbeans.*</wls:package-name>
        </wls:prefer-application-packages>
        <wls:prefer-web-inf-classes>false</wls:prefer-web-inf-classes>
        <wls:prefer-application-resources>
            <wls:resource-name>org/apache/poi/*</wls:resource-name>
            <wls:resource-name>org/apache/xmlbeans/*</wls:resource-name>
            <wls:resource-name>META-INF/services/org.apache.xmlbeans.*</wls:resource-name>
        </wls:prefer-application-resources>
    </wls:container-descriptor>
</wls:weblogic-web-app>

这种配置告诉WebLogic优先使用应用内包含的指定包，而不是服务器提供的版本。

最佳实践建议

1. 版本兼容性检查：在使用EasyExcel时，确保所有相关依赖（如POI、XMLBeans等）的版本与EasyExcel兼容
2. 依赖管理：使用Maven或Gradle等构建工具精确控制依赖版本
3. 测试环境验证：在类生产环境的测试服务器上验证Excel生成功能
4. 日志监控：在应用启动时检查类加载日志，确认加载的是预期版本的库

总结

WebLogic服务器与EasyExcel集成时出现的类加载冲突问题，本质上是由于服务器自带库与应用所需库版本不一致导致的。通过修改服务器配置或应用部署描述符，可以解决这一问题，确保Excel生成功能正常工作。在实际生产环境中，建议采用方案一作为首选解决方案，因为它能从根本上解决问题，而方案二则适用于无法修改服务器配置的场景。