巧用maven-shade-plugin解决依赖冲突

针对maven的依赖冲突通常有两种方式：

• 当冲突两者其中一方兼容另外一方时，通过exclusions和exclusion标签解决。
• 当冲突两者互不兼容时，使用maven-shade-plugin管理插件解决。

exclusions标签

  exclusions标签可以将对应依赖的依赖进行剔除，这里注意的是不能针对scope为system的属性或者是通过systemPath引入的jar包依赖，它们不受maven管理。

            org.springframework
            spring-aop
            ${spring.version}
            
                
                    commons-logging
                    commons-logging
                
            
        

maven-shade-plugin插件

  maven-shade-plugin插件可以解决冲突双方的包互相不兼容情况，其原理是修改其中任意一方的依赖路径，来解决。比如package A依赖package org.apache.common_v1,package C依赖package org.apache.common_v2，此时可以将package B_v1重新打包成package shade.org.apache.common_V1，而后修改package A的所有包引入代码，import org.apache.common修改成import shade.org.apache.common

关键词说明

                org.apache.maven.plugins
                maven-shade-plugin
                2.4.3
                
                    
                        package
                        
                            shade
                        
                        
                            true
                            
                                
                                
                                    
                                    org.slf4j
                                    
                                    shaded.org.slf4j
                                
                            
                        
                    
                
            

举例说明

整个举例说明是要解决工程中与jar包中出现的log依赖冲突。
a. 这是是我项目中的依赖（Package A）,我在工程中引入的log4j的依赖

package A截图

b. 这是我项目中的jar依赖(Package B)，我在工程中引入的无关package。

package B截图

c. 此时我发现，原先的log4j的地方报错了，点击查看引用处，是这个jar包里的log4j。

工程报错处截图

引用处截图

d. 将工程中log4j的依赖单独出来，到新工程，重新进行打包。

    4.0.0

    ceshi
    ceshi
    1.0-SNAPSHOT

    
        1.8
        1.8
        UTF-8
        1.7.7

    
    
        
            apache release
            https://repository.apache.org/content/repositories/releases/
        
    

    
        
            
            
                org.apache.maven.plugins
                maven-compiler-plugin
                
                    1.8
                    1.8
                
            
            
                org.apache.maven.plugins
                maven-shade-plugin
                2.4.3
                
                    
                        package
                        
                            shade
                        
                        
                            true
                            
                                
                                    org.slf4j
                                    shaded.org.slf4j
                                
                            
                        
                    
                
            

        
    


    

        
            org.slf4j
            slf4j-api
            ${slf4j.version}
        
        
            org.slf4j
            slf4j-log4j12
            ${slf4j.version}
        
        
        
            org.slf4j
            jcl-over-slf4j
            ${slf4j.version}
        
        
        
            org.slf4j
            jul-to-slf4j
            ${slf4j.version}
        
    

命令行执行如下操作：

C:\Users\Lczy-Huang\Desktop\ceshi>mvn package

此时你会发现打包路径会有两个包，一个是原始未加入shade的包，一个是shade的包，我们需要使用的是shade的包；通过第二张截图可以看到log4j的包路径发生了改变。

打包路径

jar包信息

e.将shade包引入工程中，删除原先的依赖，将所有的import org.slf4j替换成import shade.org.slf4。

引入shade jar包

注释掉之前依赖

修改import

f. 此时工程就可以正常启动了。

项目启动啦