自定义Spring Boot父项目的自定义Starter无法被子微服务识别

问题原因 #

你遇到的核心问题是对Maven的dependencyManagement机制理解有误：

• dependencyManagement仅负责统一管理依赖版本，不会自动将依赖引入到子项目的类路径中。它的作用是锁定版本号，避免子项目重复声明版本，同时方便后续统一升级。
• 只有父项目<dependencies>节点下的依赖，才会自动传递给所有子项目并加载到类路径。

你看到官方Spring Boot Starter能正常加载，本质是子项目主动声明了这些依赖，父项目的dependencyManagement只是帮你省略了版本号，并非自动引入。

解决方案 #

根据你的统一管理需求，结合不同业务场景，有三种可行方案：

方案1：父项目直接引入所有自定义Starter（适合所有子项目都需要这些Starter的场景） #

在父项目的<dependencies>节点下添加自定义Starter依赖（无需写版本，dependencyManagement已锁定），所有子项目继承后会自动获取这些依赖：

<!-- 父项目pom.xml -->
<dependencies>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>custom-starter-1</artifactId>
    </dependency>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>custom-starter-2</artifactId>
    </dependency>
</dependencies>

优点：子项目无需额外配置，自动获取全部自定义Starter；
缺点：若部分子项目不需要全部Starter，会引入冗余依赖。

方案2：创建聚合依赖模块（适合子项目需要灵活组合Starter的场景） #

新建一个聚合模块（如custom-spring-boot-starters），将所有自定义Starter作为该模块的依赖，子项目只需引入这一个聚合模块即可批量获取所需Starter：

1. 在父项目下新增custom-spring-boot-starters模块，其pom.xml配置如下：

<parent>
    <groupId>com.example</groupId>
    <artifactId>custom-spring-boot-parent</artifactId>
    <version>1.0.0</version>
</parent>
<artifactId>custom-spring-boot-starters</artifactId>
<packaging>pom</packaging>

<dependencies>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>custom-starter-1</artifactId>
    </dependency>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>custom-starter-2</artifactId>
    </dependency>
</dependencies>

2. 在父项目的<modules>中加入该模块：

<modules>
    <module>custom-starter-1</module>
    <module>custom-starter-2</module>
    <module>custom-spring-boot-starters</module>
</modules>

3. 子项目中只需引入聚合模块：

<!-- 微服务pom.xml -->
<dependencies>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>custom-spring-boot-starters</artifactId>
    </dependency>
</dependencies>

优点：既实现批量引入，又保留灵活性（子项目也可单独引入某一个Starter）；
缺点：需多维护一个聚合模块。

方案3：子项目按需引入自定义Starter（最灵活的场景） #

保持父项目的dependencyManagement配置不变，子项目中按需声明需要的自定义Starter依赖（无需写版本，由父项目统一管理）：

<!-- 微服务pom.xml -->
<dependencies>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>custom-starter-1</artifactId>
    </dependency>
    <!-- 按需添加其他Starter -->
</dependencies>

优点：完全按需引入，无冗余依赖；版本由父项目统一管控，避免版本不一致问题；
缺点：子项目需手动声明依赖，但这并不违背统一管理的初衷——统一管理的核心是版本控制，而非强制自动引入所有依赖。

总结 #

统一管理依赖的核心目标是版本统一、便于升级，而非让所有子项目强制引入所有依赖。选择方案时可参考：

• 所有子项目全量依赖自定义Starter → 方案1；
• 子项目需要灵活组合不同Starter → 方案2；
• 子项目仅需部分Starter → 方案3。

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