Maven踩坑——父模块生命周期的操作会被子模块继承

Maven 生命周期与阶段总结

Maven 共有三个主要生命周期，每个生命周期由多个阶段组成。以下是每个生命周期和其阶段的详细描述。

Maven 生命周期与父子模块插件执行控制

Maven 依赖于生命周期来执行构建任务，父模块和子模块会共享相同的生命周期，但通过适当的配置，可以避免子模块执行父模块的插件操作。

解决方案：通过插件的 skip 参数控制子模块跳过执行

使用插件的 skip 参数，可以让子模块不执行特定插件。例如，对于 maven-antrun-plugin 或 maven-resources-plugin，你可以在子模块的 pom.xml 中显式设置 skip 为 true。

通过插件 skip 参数避免子模块执行

以下是一个完整的配置示例：

父模块 pom.xml

<project>
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>parent-module</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <modules>
        <module>child-module1</module>
        <module>child-module2</module>
    </modules>

    <build>
        <plugins>
            <!-- 父模块执行的插件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-resources-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <id>copy-resources</id>
                        <phase>package</phase>
                        <goals>
                            <goal>copy-resources</goal>
                        </goals>
                        <configuration>
                            <resources>
                                <resource>
                                    <directory>src/main/resources</directory>
                                </resource>
                            </resources>
                            <outputDirectory>${project.build.directory}/resources</outputDirectory>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

子模块 pom.xml

在子模块中，明确配置需要跳过的插件并设置 skip 为 true：

<project>
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>com.example</groupId>
        <artifactId>parent-module</artifactId>
        <version>1.0-SNAPSHOT</version>
        <relativePath>../pom.xml</relativePath>
    </parent>

    <groupId>com.example</groupId>
    <artifactId>child-module1</artifactId>
    <version>1.0-SNAPSHOT</version>

    <build>
        <plugins>
            <!-- 配置要跳过执行的插件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-resources-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                    <skip>true</skip>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

避免子模块执行父模块插件的总结

1. 通过 skip 控制插件跳过：在子模块中，可以配置插件的 <skip> 参数为 true，从而避免子模块执行父模块的插件操作。
2. 父模块插件配置的继承：父模块的插件配置在默认情况下会继承给子模块，除非你在子模块中配置插件并显式使用 skip 参数。
3. 阶段与生命周期的控制：可以通过将插件的执行绑定到特定生命周期的阶段，来控制插件在父模块中的执行时机。