本文详解如何在 Maven 多模块项目中，通过 Profiles 实现「仅构建指定模块子集」（如 ServiceA 或 ServiceB 二选一），解决 在 profile 中声明无效、所有模块仍被扫描构建的根本原因。
本文详解如何在 maven 多模块项目中，通过 profiles 实现「仅构建指定模块子集」（如 servicea 或 serviceb 二选一），解决 `
在 Maven 的多模块构建模型中，
要真正实现「按环境只构建 A 或 B」，关键在于解耦模块声明与依赖注入：
- ✅ 父 POM 的
必须保持完整 （这是 Reactor 发现所有子模块的前提）； - ✅ 模块间的“可选依赖”必须下沉到具体子模块（如 HttpService）的 pom.xml 中，并通过 Profile 控制其激活；
- ❌ 不要试图用 profile 中的
替换全局模块列表——这是无效路径。
正确实现步骤
1. 父 POM：保留完整模块声明，仅用 Profile 控制构建行为（非模块列表）
你的根 pom.xml 中
<!-- 根 pom.xml：删除 profile 内的 <modules>，仅保留必要逻辑 -->
<profiles>
<profile>
<id>a</id>
<!-- 不再声明 <modules> -->
<properties>
<service.impl>service-a</service.impl>
</properties>
</profile>
<profile>
<id>b</id>
<properties>
<service.impl>service-b</service.impl>
</properties>
</profile>
</profiles>2. 子模块 HttpService：用 Profile 声明条件依赖
在 HttpService/pom.xml 中，移除对 ServiceA 和 ServiceB 的直接依赖，改用两个互斥的 Profile 分别引入对应实现：
<!-- HttpService/pom.xml -->
<dependencies>
<!-- 必选依赖 -->
<dependency>
<groupId>org.example</groupId>
<artifactId>Common</artifactId>
<version>${project.version}</version>
</dependency>
</dependencies>
<profiles>
<!-- 激活 Profile 'a' 时引入 ServiceA -->
<profile>
<id>a</id>
<activation>
<property>
<name>service.impl</name>
<value>service-a</value>
</property>
</activation>
<dependencies>
<dependency>
<groupId>org.example</groupId>
<artifactId>ServiceA</artifactId>
<version>${project.version}</version>
</dependency>
</dependencies>
</profile>
<!-- 激活 Profile 'b' 时引入 ServiceB -->
<profile>
<id>b</id>
<activation>
<property>
<name>service.impl</name>
<value>service-b</value>
</property>
</activation>
<dependencies>
<dependency>
<groupId>org.example</groupId>
<artifactId>ServiceB</artifactId>
<version>${project.version}</version>
</dependency>
</dependencies>
</profile>
</profiles>? 激活机制说明：
使用 property 激活更灵活，支持命令行传参（如 -Dservice.impl=service-a），也兼容 -Pa（因 profile a 中设置了 service.impl=service-a）。
3. 构建命令（推荐）
# 构建 ServiceA 方案（Common + ServiceA + HttpService） mvn clean package -Pa # 构建 ServiceB 方案（Common + ServiceB + HttpService） mvn clean package -Pb # 或显式指定 property（效果等价） mvn clean package -Dservice.impl=service-b
此时 Reactor 仍会扫描全部 4 个模块（这是 Maven 必需行为），但：
- ServiceA 和 ServiceB 因无其他模块依赖它们，不会被任何构建目标触发编译（除非显式指定 -pl）；
- HttpService 仅在对应 Profile 激活时才拉取 ServiceA 或 ServiceB 的依赖，从而确保类路径纯净；
- 最终生成的 HttpService 构建产物（如 JAR/WAR）只包含所选服务实现及其传递依赖，零冗余。
⚠️ 关键注意事项
- 不要滥用 -pl（--projects）用于日常构建：虽然 mvn -pl Common,ServiceA,HttpService clean package 能强制限定模块，但它绕过 Reactor 依赖解析，易导致 SNAPSHOT 依赖不一致、跳过父 POM 插件配置等问题，仅建议用于调试。
- 确保 ServiceA 和 ServiceB 的 artifactId 不同且语义清晰（如 service-a, service-b），避免依赖冲突。
- 若 HttpService 需在运行时动态加载实现（如 Spring @ConditionalOnProperty），请同步在代码层做适配，Maven 层仅负责构建时依赖隔离。
- Maven 3.9.0+ 对 profile 激活有增强，但上述方案兼容 Maven 3.5+ 所有主流版本。
总结
Maven 的模块发现与依赖解析是两个正交阶段：
