Maven快照版本要这样用才真的香！

Bug的身世之谜

今天又分享一个问题解决的故事。请看下图框起来的错误，明显就是找不到这个class嘛！

下面我们按照正常人的思路去排查这个问题，既然找不到class那就先看这个依赖的jar包有没有，如果没有那就是铁证如山。

但是事与愿违啊，编译后的lib目录下真的有这个包 o rder-api-2.0-SNAPSHOT.jar

还是不相信，于是将order-api-2.0-SNAPSHOT.jar解压了，看看里面到底有没有我们需要的class，真的有，此处心情沉重。

一般人到这里就会懵圈了，但我还年轻啊，脑袋还够用。接下来看看classpath的配置有没有问题，如果order-api-2.0-SNAPSHOT.jar不在classpath中，那么自然就是找不到class啊，机智的我。

于是查看了META-INF/MANIFEST.MF文件，发现里面依赖的是 order-api-2.0-20200225.024541-15.jar， 什么情况，还加上时间戳了。

终于真相大白了，classpath中指向的是 order-api-2.0-20200225.024541-15.jar， 但lib中只有 order-api-2.0-SNAPSHOT.jar。 所以找不到class是没有错的。

打包配置信息

Maven deploy的时候会自动给快照版本加时间戳，从下图可以看的出来：

下面来看下目前项目的打包配置，如下：

  org.apache.maven.plugins
  maven-jar-plugin
  2.3.1
  
    
      
        com.xxx.web.WebApp
        true
        lib/
      
    
  


  org.apache.maven.plugins
  maven-assembly-plugin

用了assembly插件，对应的配置如下：

assembly.xml

bin

    zip

false

    
        /
        false
        
            ${artifact}
        
        xxx-web.jar
    
    
        /lib
        false
        false
    

打包后目录中会有一个jar包和一个lib目录，如下：

-xxx-web.jar
-lib
  -xxx.jar
  -yyy.jar

解决方案

现在需要解决的问题是classpath中的快照依赖和lib目录中实际的jar包不一致的问题。

主要是两个插件，所以才会有不一致的情况。

maven-jar-plugin插件中可以加上false来强制打包时 MANIFEST.MF文件不记录的Jar时间戳版本。

maven-assembly-plugin插件需要在assembly.xml中进行修改，在dependencySet中增加outputFileNameMapping=${artifact.artifactId}-${artifact.baseVersion}.${artifact.extension}

来固定名称，这样就可以去掉时间戳了。

下面贴一下修改之后完整的配置:

  org.apache.maven.plugins
  maven-jar-plugin
  2.3.1
  
    
      
        com.xxx.web.WebApp
        true
        lib/
        false
      
    
  


  org.apache.maven.plugins
  maven-assembly-plugin

assembly.xml

bin

    zip

false

    
        /
        false
        
            ${artifact}
        
        xxx-web.jar
    
    
        
  ${artifact.artifactId}-${artifact.baseVersion}.${artifact.extension}  
        
        /lib
        false
        false
    

虽然解决了，但感觉还是挺麻烦的。还是spring-boot-maven-plugin插件好用啊，至少没有出现过这个时间戳的问题，新项目建议大家用spring-boot-maven-plugin插件打包。

关于作者 ：尹吉欢，简单的技术爱好者，《Spring Cloud微服务-全栈技术与案例解析》, 《Spring Cloud微服务 入门 实战与进阶》作者, 公众号 猿天地 发起人。