如何集中管理Maven公共库版本，避免多API重复更新？

嘿，我太懂你这种手动修改几十份pom的痛苦了！之前帮团队处理过几乎一模一样的场景，给你两个最实用的方案，绝对能解决你的问题：

Maven的BOM（Bill of Materials）就是专门用来统一管理依赖版本的工具，它允许你在一个中央文件里定义所有公共依赖的版本，其他项目只需要引入这个BOM，就能自动复用里面的版本号，而且完全可控，不会自动升级。

步骤1：创建你的BOM项目 #

新建一个纯Maven项目，把packaging设置为pom，然后在dependencyManagement节点里定义你的公共库版本。示例pom.xml：

<?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.yourcompany</groupId>
    <artifactId>common-lib-bom</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>
    <name>Common Library BOM</name>

    <dependencyManagement>
        <dependencies>
            <!-- 在这里统一定义你的公共库版本 -->
            <dependency>
                <groupId>com.yourcompany</groupId>
                <artifactId>your-common-library</artifactId>
                <version>2.3.0</version> <!-- 当前稳定版本 -->
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

把这个BOM项目发布到你们的私有Maven仓库（比如Nexus、Artifactory）。

步骤2：在各API项目中引用BOM #

在每个API项目的pom.xml里，先在dependencyManagement中引入BOM，然后在dependencies里引用公共库时不需要写版本号，会自动使用BOM里定义的版本：

<!-- 先引入BOM -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.yourcompany</groupId>
            <artifactId>common-lib-bom</artifactId>
            <version>1.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<!-- 引用公共库，无需指定版本 -->
<dependencies>
    <dependency>
        <groupId>com.yourcompany</groupId>
        <artifactId>your-common-library</artifactId>
    </dependency>
</dependencies>

步骤3：更新公共库版本的流程 #

当你要升级公共库到新的稳定版本（比如2.4.0）时：

1. 修改BOM项目里的公共库版本号，然后把BOM自身的版本升级（比如从1.0.0改成1.1.0），发布到仓库。
2. 通知各API项目团队，把他们pom里的BOM引用版本从1.0.0改成1.1.0——如果需要批量修改，可以用Maven的versions:update-property插件，或者IDE的全局替换工具，比手动逐个改快N倍。

这种方式完全可控：只有当你主动更新BOM并让API项目同步时，才会升级版本，绝对不会自动拉取beta版。

如果你们所有API项目本来就有统一的父项目，那用父POM来管理版本也很方便：

步骤1：在父POM中定义公共库版本 #

在父POM的dependencyManagement里加入公共库的版本定义：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.yourcompany</groupId>
            <artifactId>your-common-library</artifactId>
            <version>2.3.0</version>
        </dependency>
    </dependencies>
</dependencyManagement>

步骤2：API项目继承父POM #

每个API项目的pom.xml里指定父POM：

<parent>
    <groupId>com.yourcompany</groupId>
    <artifactId>api-parent-pom</artifactId>
    <version>1.0.0</version>
</parent>

<!-- 引用公共库，无需指定版本 -->
<dependencies>
    <dependency>
        <groupId>com.yourcompany</groupId>
        <artifactId>your-common-library</artifactId>
    </dependency>
</dependencies>

步骤3：更新版本流程 #

和BOM类似：修改父POM里的公共库版本，升级父POM自身版本，然后让各API项目同步父POM的版本即可。

不过要注意：一个Maven项目只能有一个父POM，而BOM可以同时引入多个，所以如果你们有多个公共库需要管理，BOM的灵活性更高。

不管用BOM还是父POM，核心逻辑都是版本硬编码：

• 所有依赖版本都是你在BOM/父POM里手动指定的稳定版本。
• 只有当你主动修改BOM/父POM的版本并发布，且API项目主动同步这个新版本时，才会升级依赖。
• 完全不会出现“自动拉取beta版”的情况，因为Maven只会使用你明确指定的版本号。

内容的提问来源于stack exchange，提问作者ViS