springboot 部署到 weblogic 中 jar 包冲突

Posted 2022-09-01 catoop

背景

某项目，客户要求使用已有的 weblogic 部署已经开发好的 springboot，于是乎对 springboot 进行了部分配置的调整，主要包括去除 tomcat 依赖，增加启动类的处理。

一般都会比较顺利，实际上总会遇到些小问题。

本文不赘述如何在 weblogic 中部署项目，如果你有需要，可以访问 https://www.cnblogs.com/cao-lei/p/15103199.html 参考该文章。

问题1

打包后发布到 weblogic 上启动时，如下图所示的错误：

从异常内容可以很容易判断出，这是 jar 包冲突导致的错误。

经过定位，weblogic 有个目录 wls12213\\oracle_common\\modules\\thirdparty，其中存放了一些第三方的默认的 jar 包，项目启动过程中默认是先加载这里的 jar 包，再加载项目工程中的 jar 包，因为你无法保证项目工程中的 jar 包和 weblogic 中的 jar 包版本刚好一致，所以就因为 jar 包版本不一致出现了比较常见的类加载冲突的问题。

查阅官网资料，weblogic 也有是解决方案的，可以通过新增并配置 weblogic.xml 文件来定义哪些类需要优先从项目工程包的 jar 包中加载。

配置方法如下：

在 springboot 项目代码和 resource 同级创建一个 webapp 目录，然后再 webapp 目录下创建 WEB-INF 目录，将 weblogic.xml 文件放在 WEB-INF 中，以 springboot-weblogic-demo 工程为例它的完整路径就是 springboot-weblogic-demo\\\\src\\main\\webapp\\WEB-INF\\weblogic.xml，其内容如下：

<?xml version='1.0' encoding='UTF-8'?>
<weblogic-web-app xmlns="http://xmlns.oracle.com/weblogic/weblogic-web-app"
                  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                  xsi:schemaLocation="http://xmlns.oracle.com/weblogic/weblogic-web-app http://xmlns.oracle.com/weblogic/weblogic-web-app/1.4/weblogic-web-app.xsd">

    <container-descriptor>
        <prefer-application-packages>
            <package-name>org.slf4j</package-name>
            <package-name>javax.validation.*</package-name>
            <package-name>org.hibernate.*</package-name>
            <package-name>javax.el.*</package-name>
            <package-name>org.springframework.*</package-name>
            <!--解决项目中jackson的jar包和weblogic中thirdparty的jar包冲突问题，配置优先加载项目中的jar-->
            <package-name>com.fasterxml.jackson.*</package-name>
        </prefer-application-packages>
    </container-descriptor>

    <context-root>/springboot-weblogic-demo</context-root>

</weblogic-web-app>

仅仅是添加配置了这一个文件，没有其他什么配置了，网上说的那些添加 web.xml 的操作，我这里并没有添加，示例是基于 springboot 2.7.2 正常部署运行。

问题2

部署的过程中还出现了 GC 错误 GC overhead limit exceeded，这个问题比较容易解决，给 weblogic 启动环境修改内存值，调大一些即可。

修改对应文件 D:\\weblogic\\fmw_12.2.1.3.0_wls_quick_Disk1_1of1\\wls12213\\user_projects\\domains\\base_domain\\bin\\setDomainEnv.cmd，大约在 200 行出头的位置，修改后的内容如下：

if NOT "%JAVA_VENDOR%"=="HP" (
	if "%VM_TYPE%"=="HotSpot" (
		set WLS_MEM_ARGS_64BIT=-Xms1024m -Xmx4096m
		set WLS_MEM_ARGS_32BIT=-Xms256m -Xmx512m
	)
)

重启 weblogic 服务，最开始就能看到我们修改后剩下的内存配置：

WLS_MEM_ARGS_64BIT 的原始值为 -Xms256m -Xmx512m，或者你也可以追加更多关于内存的设置，例如：-Xms512m -Xmx1024m -XX:MaxNewSize=1024m -XX:MaxPermSize=1024m

我写好的 springboot-weblogic-demo 示例工程代码的地址：https://github.com/xzxiaoshan/springboot-weblogic-demo

---

（END）