Maven-war-plugin警告消除：多模块项目跨目录打包Web资源

我之前也遇到过一模一样的情况——多模块项目里想把另一个模块的webapp目录打包到当前模块的war里，用相对路径配置后就弹出那个烦人的“目录在项目基目录之外”警告。下面给你几个靠谱的解决思路：

方案1：使用Maven War Plugin的Overlay功能（推荐） #

这是Maven官方推荐的跨模块Web资源整合方式，完全符合模块化设计，还能彻底消除警告。

步骤如下：

1. 确保module2是一个war类型的模块（如果它本身不需要单独打包成war，可以改成jar类型，但要额外配置插件把webapp目录打包到jar里，保持war类型会更简单）。
2. 在需要整合module2 web资源的目标模块（比如叫target-module）的pom.xml里，添加依赖并配置overlay：

<dependencies>
    <!-- 依赖module2 -->
    <dependency>
        <groupId>your-group-id</groupId>
        <artifactId>module2</artifactId>
        <version>your-version</version>
        <type>war</type>
        <scope>provided</scope> <!-- 若module2不需要运行时依赖，用provided即可 -->
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.3.2</version> <!-- 建议使用最新稳定版 -->
            <configuration>
                <overlays>
                    <!-- 配置overlay，引入module2的web资源 -->
                    <overlay>
                        <groupId>your-group-id</groupId>
                        <artifactId>module2</artifactId>
                        <!-- 可选：指定资源打包到war的子目录，比如<webPath>module2</webPath> -->
                    </overlay>
                </overlays>
            </configuration>
        </plugin>
    </plugins>
</build>

Maven会自动把module2的webapp内容合并到target-module的war里，全程通过依赖管理处理，完全符合Maven模块规范，不会触发路径警告。

方案2：在目标模块中配置Web资源，使用内置项目路径变量 #

如果你不想用overlay，也可以直接在目标模块的pom里配置webResources，但要替换手动相对路径为Maven内置变量，避免警告：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.3.2</version>
            <configuration>
                <webResources>
                    <resource>
                        <!-- 用父项目基准路径定位module2的webapp，比手动相对路径更可靠 -->
                        <directory>${project.parent.basedir}/module2/src/main/webapp</directory>
                        <!-- 指定打包到war的根目录，可自定义路径 -->
                        <targetPath>/</targetPath>
                        <!-- 可选：排除不需要的文件 -->
                        <!-- <excludes>
                            <exclude>WEB-INF/web.xml</exclude>
                        </excludes> -->
                    </resource>
                </webResources>
            </configuration>
        </plugin>
    </plugins>
</build>

${project.parent.basedir}是Maven内置变量，能精准获取顶层项目的根路径，以此定位跨模块目录不会触发“目录在项目基目录之外”的警告。

方案3：将module2的web资源打包成独立资源模块 #

如果module2的web资源需要被多个模块引用，可以把它单独做成一个jar类型的资源模块：

1. 创建新模块（比如叫web-resources-module），把module2/src/main/webapp的内容移到这个模块的src/main/resources/META-INF/resources目录（Servlet 3.0+规范默认的Web资源目录，会被自动识别）。
2. 在需要引用资源的模块里添加依赖：

<dependency>
    <groupId>your-group-id</groupId>
    <artifactId>web-resources-module</artifactId>
    <version>your-version</version>
</dependency>

Maven会自动把资源模块里的Web资源打包到目标war的对应位置，无需额外配置war插件，也不会有任何警告。

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