Maven多模块项目如何通过Profile按需构建互斥模块？

现有一个包含以下模块的Maven项目：

• Common（定义通用接口与工具类）
• ServiceA（依赖Common）
• ServiceB（依赖Common）
• HttpService（依赖Common，且需ServiceA或ServiceB其中一个）

ServiceA与ServiceB为互斥模块，二者向HttpService提供相同Bean但内部实现差异极大。构建部署时希望根据环境变量或构建参数，仅构建其中一个模块。

尝试通过根pom.xml定义Profile实现按需构建，但执行mvn clean package -P a时，ServiceB仍会被构建，且HttpService的pom.xml中仅依赖Common，无对ServiceA或ServiceB的显式依赖。当前根POM内容如下：

<?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>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.7</version>
        <relativePath/>
    </parent>

    <groupId>org.example</groupId>
    <artifactId>untitled</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>Common</module>
        <module>HttpService</module>
        <module>ServiceA</module>
        <module>ServiceB</module>
    </modules>

    <profiles>
        <profile>
            <id>a</id>
            <modules>
                <module>Common</module>
                <module>ServiceA</module>
                <module>HttpService</module>
            </modules>
        </profile>
        <profile>
            <id>b</id>
            <modules>
                <module>Common</module>
                <module>ServiceB</module>
                <module>HttpService</module>
            </modules>
        </profile>
    </profiles>

</project>

1. 修正Profile模块覆盖逻辑 #

Maven中根POM的全局<modules>会与Profile中的<modules>合并，而非替换，这是指定Profile后ServiceB仍被构建的核心原因。需要移除全局模块列表，完全通过Profile控制要构建的模块：

修改后的根POM：

<?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>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.7</version>
        <relativePath/>
    </parent>

    <groupId>org.example</groupId>
    <artifactId>untitled</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>

    <!-- 移除全局modules，所有模块由Profile控制 -->
    <profiles>
        <!-- 默认Profile：未指定参数时仅构建Common，避免误操作 -->
        <profile>
            <id>default</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <modules>
                <module>Common</module>
            </modules>
        </profile>
        <profile>
            <id>a</id>
            <modules>
                <module>Common</module>
                <module>ServiceA</module>
                <module>HttpService</module>
            </modules>
        </profile>
        <profile>
            <id>b</id>
            <modules>
                <module>Common</module>
                <module>ServiceB</module>
                <module>HttpService</module>
            </modules>
        </profile>
    </profiles>

</project>

此时执行mvn clean package -P a，只会构建Common、ServiceA、HttpService三个模块，ServiceB不会被触发构建。

2. 补全HttpService的依赖关联 #

HttpService需要ServiceA或ServiceB的实现类，但当前无显式依赖，会导致运行时找不到Bean。通过Profile在HttpService的POM中动态引入对应依赖：

修改HttpService的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">
    <parent>
        <artifactId>untitled</artifactId>
        <groupId>org.example</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>HttpService</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.example</groupId>
            <artifactId>Common</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
    </dependencies>

    <profiles>
        <profile>
            <id>a</id>
            <dependencies>
                <dependency>
                    <groupId>org.example</groupId>
                    <artifactId>ServiceA</artifactId>
                    <version>1.0-SNAPSHOT</version>
                </dependency>
            </dependencies>
        </profile>
        <profile>
            <id>b</id>
            <dependencies>
                <dependency>
                    <groupId>org.example</groupId>
                    <artifactId>ServiceB</artifactId>
                    <version>1.0-SNAPSHOT</version>
                </dependency>
            </dependencies>
        </profile>
    </profiles>

</project>

激活Profile a时，HttpService自动依赖ServiceA；激活b时依赖ServiceB，保证编译和运行时的依赖完整性。

3. 可选：用环境变量/构建参数动态选择（适配CI/CD） #

如果需要通过环境变量或构建参数动态指定模块，可以用Maven属性触发Profile：

修改根POM的Profile配置：

<profiles>
    <profile>
        <id>service-a</id>
        <activation>
            <property>
                <name>service.type</name>
                <value>a</value>
            </property>
        </activation>
        <modules>
            <module>Common</module>
            <module>ServiceA</module>
            <module>HttpService</module>
        </modules>
    </profile>
    <profile>
        <id>service-b</id>
        <activation>
            <property>
                <name>service.type</name>
                <value>b</value>
            </property>
        </activation>
        <modules>
            <module>Common</module>
            <module>ServiceB</module>
            <module>HttpService</module>
        </modules>
    </profile>
    <!-- 默认Profile -->
    <profile>
        <id>default</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <modules>
            <module>Common</module>
        </modules>
    </profile>
</profiles>

执行构建时通过-D参数传递：

# 构建ServiceA版本
mvn clean package -Dservice.type=a

# 构建ServiceB版本
mvn clean package -Dservice.type=b

这种方式更适合CI/CD流水线，可直接通过环境变量注入service.type参数。

内容的提问来源于stack exchange，提问作者Green 绿色