核心Web应用可选Jar模块扩展的Maven依赖统一管理咨询

我之前帮好几个做模块化Web应用的团队解决过类似问题，核心痛点就是既要保持模块的独立性，又要避免依赖版本混乱。给你几个经过实践验证的方案：

方案1：用Maven BOM（依赖管理项目）统一版本 #

这是最推荐的方式，完全脱离父模块的强绑定，同时能彻底统一所有项目的依赖版本。

你可以创建一个单独的Maven项目，打包类型设为pom，这个项目里不需要任何源码，只负责定义所有共用依赖的版本：

<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>web-platform-bom</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>
    <name>Web Platform BOM</name>

    <dependencyManagement>
        <dependencies>
            <!-- 核心Web应用的依赖 -->
            <dependency>
                <groupId>com.yourcompany</groupId>
                <artifactId>core-web-app</artifactId>
                <version>2.3.0</version>
            </dependency>
            <!-- Servlet、Filter等Web组件依赖 -->
            <dependency>
                <groupId>javax.servlet</groupId>
                <artifactId>javax.servlet-api</artifactId>
                <version>4.0.1</version>
                <scope>provided</scope>
            </dependency>
            <!-- 其他共用依赖（比如Spring、Jackson等） -->
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-web</artifactId>
                <version>5.3.20</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

然后在你的核心Web应用和每个可选模块的pom.xml里，导入这个BOM，之后引用依赖时就不需要写版本号了，自动使用BOM里定义的版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.yourcompany</groupId>
            <artifactId>web-platform-bom</artifactId>
            <version>1.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <!-- 引用核心应用，无需指定版本 -->
    <dependency>
        <groupId>com.yourcompany</groupId>
        <artifactId>core-web-app</artifactId>
    </dependency>
    <!-- 引用Servlet API，版本自动从BOM获取 -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <scope>provided</scope>
    </dependency>
</dependencies>

优点：

• 核心应用和所有模块完全独立，没有父项目的强制绑定
• BOM可以单独迭代版本，升级依赖时只需要修改BOM，所有导入它的项目都会自动同步
• 完全符合Maven的依赖管理规范，不会有隐藏的版本冲突

方案2：配合Maven属性增强灵活性 #

如果需要更灵活的版本管理（比如同一BOM里区分环境版本），可以在BOM里用<properties>定义版本变量，再在依赖中引用：

<properties>
    <core-app.version>2.3.0</core-app.version>
    <servlet-api.version>4.0.1</servlet-api.version>
    <spring.version>5.3.20</spring.version>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.yourcompany</groupId>
            <artifactId>core-web-app</artifactId>
            <version>${core-app.version}</version>
        </dependency>
        <!-- 其他依赖引用对应的变量 -->
    </dependencies>
</dependencyManagement>

这样升级某个依赖时，只需要修改BOM里的属性值，所有关联项目都会自动生效，非常省心。

方案3：定期检查依赖树避免冲突 #

不管用哪种方案，都建议定期检查依赖树，排查潜在的版本冲突。在核心应用或模块的目录下执行：

mvn dependency:tree -Dverbose

这个命令会列出所有依赖的完整层级和版本，如果发现某个依赖版本和BOM定义的不一致，就可以通过<exclusions>排除掉冲突的依赖，或者在BOM里明确锁定版本。

额外提示：模块部署的类加载注意事项 #

因为你的模块是包含Servlet/Filter的Jar包，要注意类加载问题：

• 建议把核心应用的公共API（比如接口、模型类）抽成单独的Jar（比如core-api）
• 可选模块只依赖core-api（compile scope），核心应用本身包含API的实现
• 部署时，核心应用的实现Jar和模块Jar都放在Web应用的WEB-INF/lib下，避免重复打包导致的类冲突

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