在多模块或者多项目相互依赖的Maven构建场景中，快照版本依赖的版本号频繁变动，手动逐个修改pom文件中的版本号不仅耗时，还容易出现版本不一致的问题，导致构建失败或者运行时出现兼容性问题。因此需要一套自动化的机制来同步快照依赖的版本。
方案一：使用Maven属性统一版本管理
最基础的方式是在父项目或者统一的版本管理项目中定义属性，所有子项目或者依赖项目都引用该属性作为快照版本号，修改时只需要调整属性值即可同步所有引用位置。
父项目pom配置示例
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>parent-project</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>pom</packaging>
<!-- 定义快照版本属性 -->
<properties>
<common-module.version>1.2.3-SNAPSHOT</common-module.version>
<utils-module.version>2.0.1-SNAPSHOT</utils-module.version>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.example</groupId>
<artifactId>common-module</artifactId>
<version>${common-module.version}</version>
</dependency>
<dependency>
<groupId>com.example</groupId>
<artifactId>utils-module</artifactId>
<version>${utils-module.version}</version>
</dependency>
</dependencies>
</dependencyManagement>
</project>
子项目引用示例
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.example</groupId>
<artifactId>parent-project</artifactId>
<version>1.0.0-SNAPSHOT</version>
</parent>
<artifactId>sub-project</artifactId>
<dependencies>
<dependency>
<groupId>com.example</groupId>
<artifactId>common-module</artifactId>
<!-- 无需写版本号，自动继承父项目属性定义的版本 -->
</dependency>
</dependencies>
</project>
方案二：使用Versions Maven Plugin自动更新版本
如果项目没有统一的父项目，或者需要跨项目更新版本，可以使用Versions Maven Plugin插件批量修改pom文件中的快照版本号。
插件配置示例
<build>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>versions-maven-plugin</artifactId>
<version>2.10.0</version>
</plugin>
</plugins>
</build>
常用更新命令
- 更新所有依赖的快照版本到最新：
mvn versions:use-latest-snapshots - 更新指定依赖的版本：
mvn versions:set-property -Dproperty=common-module.version -DnewVersion=1.2.4-SNAPSHOT - 提交版本修改：
mvn versions:commit - 回滚版本修改：
mvn versions:revert
方案三：结合CI/CD流水线自动同步
可以在Jenkins、GitLab CI等流水线中添加版本同步步骤，当有新的快照版本发布到私服时，自动更新依赖项目的pom文件并提交代码。
GitLab CI配置示例
sync_snapshot_version:
stage: build
script:
# 安装Maven
- apt-get update && apt-get install -y maven
# 更新所有快照依赖到最新版本
- mvn versions:use-latest-snapshots -DallowSnapshots=true
# 提交修改到当前分支
- git config --global user.name "CI Bot"
- git config --global user.email "ci@ipipp.com"
- git add pom.xml
- git commit -m "Auto sync snapshot dependencies version"
- git push origin $CI_COMMIT_BRANCH
only:
- develop
注意事项
- 快照版本仅用于开发阶段，正式发布时需要替换为正式版本，避免依赖不稳定
- 使用属性管理版本时，建议将版本属性放在统一的版本管理项目中，避免分散修改
- 自动同步版本前建议先执行单元测试，确保版本更新后不会引入兼容性问题
- 私服需要开启快照版本自动清理策略，避免旧快照版本占用过多存储空间