在使用Maven进行项目构建时，如果项目的src/main/java或者src/main/resources目录为空，执行mvn package命令打包生成JAR文件时，会出现JAR为空的警告提示，这类提示会干扰构建日志的阅读，在多模块项目中尤其影响问题排查。我们可以通过调整Maven JAR插件的配置，让构建过程忽略空的main目录，从而消除这类警告。
问题产生的原因
Maven默认的JAR插件在打包时，会检查main目录下的资源是否存在，如果main目录下没有可打包的类和资源文件，插件会判定当前要生成的JAR包为空，从而输出警告信息。这类情况常出现在仅作为父模块的项目、仅包含测试代码的模块，或者临时创建的空模块中。
具体配置方案
我们可以在项目的pom.xml文件中配置maven-jar-plugin插件，设置skipIfEmpty参数为true，这样当main目录为空时，插件会自动跳过JAR打包过程，不会生成空的JAR文件，也不会输出对应的警告。
配置示例
在pom.xml的<build>标签下的<plugins>中添加如下配置：
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.3.0</version>
<configuration>
<!-- 当main目录为空时跳过JAR打包，消除空JAR警告 -->
<skipIfEmpty>true</skipIfEmpty>
</configuration>
</plugin>
</plugins>
</build>
配置参数说明
上述配置中的核心参数是skipIfEmpty，它的取值和含义如下：
| 参数值 | 含义 |
|---|---|
| true | 当main目录为空时，跳过JAR打包过程，不会生成JAR文件，也不会输出空JAR警告 |
| false | 默认值，即使main目录为空，也会尝试生成JAR文件，若为空则输出警告信息 |
适用场景说明
该配置适合以下场景使用：
- 多模块项目中仅作为聚合模块的父项目，不需要生成可执行的JAR包
- 仅包含测试代码的模块，main目录下没有业务代码和资源
- 临时创建的空模块，后续才会补充业务代码，暂时不需要打包
如果项目确实需要生成空的JAR包，比如某些框架要求必须存在对应的JAR文件，那么就不要设置skipIfEmpty参数，或者将其设置为false即可。
验证配置效果
配置完成后，执行mvn clean package命令，当main目录为空时，构建日志中不会再出现JAR为空的警告信息，同时target目录下也不会生成对应的空JAR文件。如果main目录下有正常的业务代码，插件会正常执行打包流程，生成可用的JAR包，不会受到该配置的影响。
Mavenempty_main_directoryskip_empty_jarmaven_jar_plugin修改时间：2026-07-06 00:12:20