跳至主要內容

md-bom 与 md-all（依赖管理）

1. 模块定位

md-bom 与 md-all 都是无 Java 代码的依赖管理模块，解决两个问题：

模块Maven 坐标职责
md-bomtop.mddata.base:md-bomBOM（Bill of Materials）：dependencyManagement 统一声明全部内部构件版本，下游 import 后引依赖不写版本号
md-alltop.mddata.base:md-all聚合 POM，含两个「一键依赖」子模块
md-all/md-all-boottop.mddata.base:md-all-boot单体架构-依赖管理：一个依赖引入 15 个常用模块
md-all/md-all-cloudtop.mddata.base:md-all-cloud微服务架构-依赖管理：= md-all-boot + md-cloud-starter

三者均继承 mdp-parent，版本随 ${revision} 统一发布。

2. 源码解读

2.1 md-bom 管理的构件清单

md-bom/pom.xml 的 dependencyManagement 声明了 24 个内部构件，按用途分组：

2.2 md-all-boot：单体应用的「一键依赖」

md-all-boot/pom.xml 聚合以下 15 个模块（dependency 列表实测）：

md-annotation、md-core、md-json-starter、md-util、md-cache-starter、
md-db-uid、md-db-mybatis-flex、md-boot、md-echo-starter、md-log-starter、
md-mvc-flex、md-openapi3-starter、md-scan-starter、md-validator-starter、md-xss-starter

注意：聚合中不包含 md-db（它已被 md-db-mybatis-flex 传递引入）、验证码、代码生成器、PowerJob、sa-token、sop —— 这些按需单独引入。

2.3 md-all-cloud：微服务应用的一键依赖

md-all-cloud/pom.xml 只有两个依赖：

<dependency>
    <groupId>top.mddata.base</groupId>
    <artifactId>md-all-boot</artifactId>
</dependency>
<dependency>
    <groupId>top.mddata.base</groupId>
    <artifactId>md-cloud-starter</artifactId>
</dependency>

即微服务应用 = 单体全家桶 + Feign/负载均衡/灰度/Sentinel 支持（见 md-cloud-starter）。

3. 可配置参数

无。依赖管理模块不含任何运行期配置。

4. 扩展点

  • 二开工程标准接入方式：
<!-- 1. import BOM 获得版本仲裁 -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>top.mddata.base</groupId>
            <artifactId>md-bom</artifactId>
            <version>${mdp.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<!-- 2. 按架构形态引入一键依赖 -->
<dependency>
    <groupId>top.mddata.base</groupId>
    <artifactId>md-all-boot</artifactId>   <!-- 或 md-all-cloud -->
</dependency>
  • 不想全家桶时，跳过 md-all，直接从 md-bom 管理的清单中按需挑选单个 starter。

5. 功能扩展建议

想做什么推荐做法
新增内部公共模块在 mdp-base 下建模块 → 在 md-bom 的 dependencyManagement 登记 → 视情况加入 md-all-boot
排除全家桶中不需要的模块对 md-all-boot 加 <exclusions>；更干净的做法是不用 md-all，逐个显式引入所需模块
二开工程统一版本只 import md-bom，禁止在业务工程里为 md 构件写死版本号，防止升级时版本漂移

6. 二次开发注意事项

高频坑点

  1. md-bom 只管理版本，不引入依赖：import md-bom 后仍必须显式声明需要的构件，常见误区是「import 了 BOM 类就能用」。
  2. md-all-boot 是传递依赖大户：引入后 mvn dependency:tree 会膨胀，排查类冲突时先确认是否由全家桶传递引入。
  3. 升级平台版本只改一处：业务工程中用属性（如 ${mdp.version}）统一引用 md-bom 版本，避免多个 md 构件版本不一致导致 NoSuchMethodError。
    :::
Copyright © 2026-present henhen6