构建与依赖 / 系统课时

快照版本与正式版本

快照版本与正式版本

1.0-SNAPSHOT 和 1.0 的差别不只是名字里多了一个后缀:前者允许同一逻辑版本持续发布新构建,后者应当一经发布就保持不变。本课用本地文件型远程仓库实际部署两次快照,观察时间戳文件名,并说明 Maven 何时检查更新。

学习目标

  • 理解 SNAPSHOT、时间戳快照与构建序号之间的关系。
  • 说明 updatePolicy 与 -U 为什么会影响快照刷新。
  • 区分开发期快照和正式发布版本的使用边界。

SNAPSHOT 为什么会变成时间戳文件

项目依赖可以声明为 com.example:demo-lib:1.0-SNAPSHOT,但部署到远程快照仓库后,实际文件通常会变成 demo-lib-1.0-<TIMESTAMP>-<BUILD_NUMBER>.jar。仓库中的 maven-metadata.xml 保存时间戳版本信息,消费者仍然声明 1.0-SNAPSHOT,不需要把时间戳写进 POM。

同一个 1.0-SNAPSHOT 可以连续部署多次,所以它适合联调和开发中间产物。新的部署产生新的时间戳制品,构建序号也随发布递增;因此两台机器在不同时间解析同一个 SNAPSHOT 坐标时,拿到的文件内容可能不同。

Maven SNAPSHOT 到时间戳快照的解析关系

用本地远程仓库观察两次部署

下面示例适用于安装了 JDK 与 Maven 的 macOS/Linux Bash 环境。它创建一个空 JAR,把同一个 1.0-SNAPSHOT 连续部署两次到 file:// 仓库,然后只列出生成的 JAR 文件名。示例显式固定 Maven Deploy Plugin 3.1.2。

bash
rm -rf snapshot-demo snapshot-repo
mkdir -p snapshot-demo/empty snapshot-repo
jar --create --file snapshot-demo/demo.jar -C snapshot-demo/empty .
REPO_URL="file://$PWD/snapshot-repo"
for n in 1 2; do
  mvn -q org.apache.maven.plugins:maven-deploy-plugin:3.1.2:deploy-file -Durl="$REPO_URL" -DrepositoryId=local-snapshot -DgroupId=com.example -DartifactId=demo-lib -Dversion=1.0-SNAPSHOT -Dpackaging=jar -Dfile=snapshot-demo/demo.jar
  sleep 2
done
for f in snapshot-repo/com/example/demo-lib/1.0-SNAPSHOT/*.jar; do
  basename "$f"
done

预期输出:

text
demo-lib-1.0-<TIMESTAMP1>-1.jar
demo-lib-1.0-<TIMESTAMP2>-2.jar

<TIMESTAMP1> 与 <TIMESTAMP2> 是实际部署时间形成的动态值。第二次部署通常使用递增后的构建序号 2;同目录还会出现 POM、maven-metadata.xml 和校验文件,它们共同让解析器把逻辑版本 1.0-SNAPSHOT 映射到具体制品。

Maven 什么时候检查新的快照

远程仓库的快照检查频率由 repository policy 的 updatePolicy 控制,常见值包括 always、daily、interval:X 和 never;未显式指定时通常使用 daily。因此版本名带有 SNAPSHOT,并不意味着 Maven 每次构建都会重新下载文件。

需要临时强制检查更新时,可以给 Maven 构建增加 -U。该选项会强制检查远程仓库中更新的 SNAPSHOT,并重新检查此前缺失的 release;如果仓库里没有更新的时间戳制品,解析完成后仍可能继续使用已有内容。

开发机若把策略设为 always,每次构建都会增加远程检查;大型多模块项目或跨地域仓库下会产生明显延迟。高频联调时可以采用较积极的检查策略,普通开发环境保留 daily,确实需要立即刷新时再使用 -U。

正式版本为什么应保持不可变

正式版本例如 1.0.0 应代表确定的一组制品内容和依赖描述。如果相同坐标被覆盖,已经缓存旧文件的 CI、开发机和生产环境可能在相同版本号下运行不同代码,构建结果就无法可靠复现。

实际发布可以采用明确的版本推进方式:开发阶段使用 1.1.0-SNAPSHOT,内容确认后发布 1.1.0;后续修复不要覆盖 1.1.0,而是发布 1.1.1。Maven Central 这类发布仓库也不允许用同一坐标重新发布已经存在的正式版本。

正式交付前至少检查三项:项目版本不含 SNAPSHOT;依赖树中没有意外的快照依赖;目标发布仓库中尚不存在相同正式坐标。这样版本号才能稳定对应唯一发布结果,而不是随时间改变内容。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

快照版本与正式版本

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通