快捷導(dǎo)航

關(guān)于jdk8升級jdk21 cxf報錯的踩坑記錄

更新時間：2024年10月09日 09:14:46 作者：照貓畫狐

在升級Java項(xiàng)目時,從JDK1.8和Spring2遷移到JDK21和Spring3后,遇到了JAXBException錯誤,原因是從JDK11開始移除了jaxb模塊,而cxf在編譯動態(tài)客戶端時默認(rèn)classpath不包含必要的類,解決方法是在jar包同級目錄創(chuàng)建libs并添加jakarta.xml.bind-api

項(xiàng)目場景

聽說jdk21有很多實(shí)用新特性，就想弄個玩玩，閑來無事把公司項(xiàng)目從spring2+jdk1.8直升到spring3+jdk21，折騰兩天升級完了，本以為就這么簡單結(jié)束了。

直到把項(xiàng)目發(fā)布到服務(wù)器測試調(diào)用第三方接口，一直報錯：

jakarta.xml.bind.JAXBException: "com.xx.xx" 不包含 ObjectFactory.class 或 jaxb.index

各種百度，翻看源碼，折騰兩個星期也未能解決問題，一度想要放棄。

經(jīng)過這么長時間折騰，我發(fā)現(xiàn)在IDEA中調(diào)用接口就不會報錯，一旦打成jar使用java -jar執(zhí)行就一定會報錯，這一定是jvm環(huán)境問題！

我用jconsole連接兩種不同場景下的jvm，經(jīng)過自己反復(fù)對比調(diào)試，終于發(fā)現(xiàn)了問題所在。

問題描述

使用cxf創(chuàng)建動態(tài)客戶端時報錯：

jakarta.xml.bind.JAXBException: "com.xx.xx" 不包含 ObjectFactory.class 或 jaxb.index

// 創(chuàng)建動態(tài)客戶端
JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
Client client = dcf.createClient(addr);
client.invoke(methodName, param);

原因分析

從jdk11起移除了jaxb模塊，cxf編譯動態(tài)客戶端代碼時，默認(rèn)的classpath為java.class.path

當(dāng)打包成jar后，java.class.path指定的目錄就是當(dāng)前運(yùn)行的jar

由于jdk11也移除了rt.jar、tool.jar，cxf編譯動態(tài)客戶端java文件時，會因?yàn)檎也坏揭蕾嚨膉ar包報錯

解決方案

1. 在jar包同級目錄下新建一個libs目錄，放入jakarta.xml.bind-api-4.0.2.jar

2. 項(xiàng)目啟動時，把cxf編譯動態(tài)客戶端所依賴的jar包添加到j(luò)ava.class.path中。

// 獲取當(dāng)前jar所在目錄
String jarPath = (System.getProperty("user.dir")).replaceAll("\\\\", "/").replace("file:/", "/");
String classPath = jarPath + "/libs/jakarta.xml.bind-api-4.0.2.jar";

// 因?yàn)閺膉dk11起移除了jaxb模塊，cxf編譯動態(tài)客戶端代碼時，默認(rèn)的classpath為java.class.path，由于jdk11也移除了rt.jar、tool.jar，會導(dǎo)致編譯異常，報錯：
// jakarta.xml.bind.JAXBException: "com.xx.xx" 不包含 ObjectFactory.class 或 jaxb.index
System.setProperty("java.class.path", System.getProperty("java.class.path") + ";" + classPath + ";");

上面提供的示例程序，僅供參考