maven中snapshot快照库与maven-metadata.xml

最新推荐文章于 2025-05-12 18:33:22 发布

lxlmycsdnfree

最新推荐文章于 2025-05-12 18:33:22 发布

阅读量1w

点赞数 3

CC 4.0 BY-SA版权

分类专栏： maven

本文链接：https://blog.csdn.net/lxlmycsdnfree/article/details/77835771

maven 专栏收录该内容

11 篇文章

订阅专栏

本文介绍了Maven中快照版本(snapshot)的概念及其在开发过程中的应用。快照版本允许开发者在开发阶段频繁地更新和测试不稳定库，而无需更改版本号。文章详细解释了如何在POM文件中定义快照版本，以及Maven如何处理快照版本的更新。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在使用maven过程中，我们在开发阶段经常性的会有很多公共库处于不稳定状态，随时需要修改并发布，可能一天就要发布一次，遇到bug时，甚至一天要发布N次。我们知道，maven的依赖管理是基于版本管理的，对于发布状态的artifact，如果版本号相同，即使我们内部的镜像服务器上的组件比本地新，maven也不会主动下载的。

如果我们在开发阶段都是基于正式发布版本来做依赖管理，那么遇到这个问题，就需要升级组件的版本号，可这样就明显不符合要求和实际情况了。但是，如果是基于快照版本，那么问题就自热而然的解决了，而maven已经为我们准备好了这一切。

maven中的仓库分为两种，snapshot快照仓库和release发布仓库。snapshot快照仓库用于保存开发过程中的不稳定版本，release正式仓库则是用来保存稳定的发行版本。定义一个组件/模块为快照版本，只需要在pom文件中在该模块的版本号后加上-SNAPSHOT即可(注意这里必须是大写)，如下：

<groupId>cc.mzone</groupId>
<artifactId>m1</artifactId>
<version>0.1-SNAPSHOT</version>
<packaging>jar</packaging>

maven2会根据模块的版本号(pom文件中的version)中是否带有-SNAPSHOT来判断是快照版本还是正式版本。如果是快照版本，那么在mvn deploy时会自动发布到快照版本库中，而使用快照版本的模块，在不更改版本号的情况下，直接编译打包时，maven会自动从镜像服务器上下载最新的快照版本。如果是正式发布版本，那么在mvn deploy时会自动发布到正式版本库中，而使用正式版本的模块，在不更改版本号的情况下，编译打包时如果本地已经存在该版本的模块则不会主动去镜像服务器上下载。

所以，我们在开发阶段，可以将公用库的版本设置为快照版本，而被依赖组件则引用快照版本进行开发，在公用库的快照版本更新后，我们也不需要修改pom文件提示版本号来下载新的版本，直接mvn执行相关编译、打包命令即可重新下载最新的快照库了，从而也方便了我们进行开发。

快照版本的管理的本质是metadata.xml，里面有时间戳的对比，（以时间作为标准而不是版本号）：

metadata.xml 例子：

<?xml version="1.0" encoding="UTF-8"?>
<metadata modelVersion="1.1.0">
  <groupId>com.my.testu</groupId>
  <artifactId>testu</artifactId>
  <version>1.0.1-SNAPSHOT</version>
  <versioning>
    <snapshot>
      <localCopy>true</localCopy>
    </snapshot>
    <lastUpdated>20130307084852</lastUpdated>
    <snapshotVersions>
      <snapshotVersion>
        <extension>jar</extension>
        <value>1.0.1-SNAPSHOT</value>
        <updated>20110407084852</updated>
      </snapshotVersion>
      <snapshotVersion>
        <extension>pom</extension>
        <value>1.0.1-SNAPSHOT</value>
        <updated>20110407084852</updated>
      </snapshotVersion>
    </snapshotVersions>
  </versioning>
</metadata>

这个时候，你运行项目（项目依赖快照testu-jar）maven做了什么呢（背景：设置本地通过配置镜像，使本地Maven的任何资源都是从远程仓库的Maven服务器下载的）？

Step1：从远程的Maven服务器上下载maven-metadata.xml，重命名为“maven-metadata-<RepositoryID>.xml”，并保存到本地仓库相应目录。

Step2：比较maven-metadata-local.xml与maven-metadata-<RepositoryID>.xml中的lastUpdated时间戳的值。

如果maven-metadata-local.xml中的时间戳比较大，则终止。
如果maven-metadata-<RepositoryID>.xml中的时间戳较大，则从仓库Maven服务器上下载最新版本。即：testu-1.0.1-20130407.081828-34.jar。这个过程分两步：（1）下载testu-1.0.1-20130407.081828-34.jar到本地Maven仓库。（2）将testu-1.0.1-20130407.081828-34.jar复制一份，覆盖掉原先的testu-1.0.1-SNAPSHOT.jar。也就是说，如果Maven从远程仓库下载了最新的SNAPSHOT发布包的话，那么最新的待时间戳的包和xxx-SNAPSHOT包是完全一样的。