背景:最近改造一個可執行jar包項目為spring+maven+mybatis框架,在對項目進行package后運行時遇到了報錯
開發環境
操作系統:mac os x
IDE:intellij idea
maven版本:3.3.9
問題回放
項目是一個idea的典型多模塊項目(有3個模塊,其中2個模塊我們稱之為A和B吧,都是spring的項目,模塊A依賴模塊B,模塊A是最終需要打包的模塊),父項目的pom.xml僅做模塊依賴管理用
1.在A模塊的pom.xml中添加assembly插件的配置
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<version>2.4</version>
<configuration>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef>
</descriptorRefs>
</configuration>
</plugin>
2.在A模塊的目錄下運行打包命令:mvn assembly:assembly
其中的original-xxx.jar是不帶依賴模塊的jar包,而xxx.jar便是帶依賴模塊的jar包
3.通過命令java -jar xxx.jar運行程序,發現錯誤信息如下:Configuration problem: Unable to locate Spring NamespaceHandler for XML schema namespace [http://www.springframework.org/schema/context]
這是 assembly 插件的一個 bug:http://jira.codehaus.org/browse/MASSEMBLY-360,它在對第三方打包時,對于 META-INF 下的 spring.handlers,spring.schemas 等多個同名文件進行了覆蓋,遺漏掉了一些版本的 xsd 本地映射。
如何查看打包后的spring.handlers,spring.schemas文件?
將打包后的jar包解壓(如果不能解壓,改后綴名為zip),在解壓后的目錄里面找到META-INF目錄,下面就有這幾個spring的文件:
當對模塊A進行打包時,由于依賴B,且2個模塊都是基于spring框架,各自有獨立的spring相關配置文件,在使用assembly插件進行打包時,這些配置文件會相互覆蓋掉
解決方法
更換為maven-shade-plugin插件來進行打包:
模塊A的pom.xml配置如下:
<!--shade plugins-->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>1.4</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<transformers>
<transformer
implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
<resource>META-INF/spring.handlers</resource>
</transformer>
<transformer
implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
<resource>META-INF/spring.schemas</resource>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>