Jenkins(Linux)环境下Maven无法拾取前端模块资源问题

你遇到的问题核心是Maven资源处理阶段与前端构建阶段的顺序不匹配，加上Linux和Windows的文件系统特性差异（比如Linux严格区分大小写、缓存机制不同）导致的。我来一步步帮你排查和解决：

一、核心原因分析 #

你的frontend-maven-plugin把前端构建（npm run-script build）放在了prepare-package阶段，但Maven默认的process-resources阶段（处理资源文件并复制到target目录）是在prepare-package之前执行的。也就是说：

• 当Maven尝试读取dist目录下的资源时，前端还没完成构建，dist目录是空的或者还没生成；
• Windows环境下可能因为之前构建残留的dist目录存在，或者文件系统缓存让Maven“误以为”目录有内容，所以能正常打包；
• 而Linux环境下每次构建都是干净的（比如Jenkins会执行clean），所以dist目录在process-resources阶段确实为空，导致Maven抛出JAR will be empty警告，最终Jar包没有资源。

二、具体解决方案 #

方案1：调整前端构建的执行阶段 #

把前端构建的阶段从prepare-package提前到generate-resources，确保在Maven处理资源前，dist目录已经生成完毕：

修改你的frontend-maven-plugin中node build app的执行配置：

<execution>
  <id>node build app</id>
  <!-- 把阶段改为generate-resources，确保在process-resources前执行 -->
  <phase>generate-resources</phase>
  <goals>
    <goal>npm</goal>
  </goals>
  <configuration>
    <arguments>run-script build</arguments>
  </configuration>
</execution>

方案2：强制Maven在打包前重新处理资源 #

如果不想调整前端构建阶段，可以配置maven-resources-plugin在prepare-package阶段再执行一次资源复制，确保能捕获到刚生成的dist目录内容：

在build/plugins中添加：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-resources-plugin</artifactId>
  <executions>
    <execution>
      <id>copy-resources-after-build</id>
      <phase>prepare-package</phase>
      <goals>
        <goal>copy-resources</goal>
      </goals>
      <configuration>
        <outputDirectory>${project.build.outputDirectory}</outputDirectory>
        <resources>
          <resource>
            <directory>dist</directory>
            <filtering>false</filtering>
          </resource>
        </resources>
      </configuration>
    </execution>
  </executions>
</plugin>

方案3：检查路径大小写一致性（Linux专属） #

Linux文件系统严格区分大小写，确认以下几点：

• pom.xml中<directory>dist</directory>的大小写，和实际生成的目录名完全一致（比如不要写成Dist或者DIST）；
• npm构建命令ng build --output-path dist/META-INF/resources中的路径大小写，和pom中的配置匹配；
• 可以在Jenkins构建脚本中添加ls -l命令，查看工作目录下的dist目录结构是否符合预期。

三、验证步骤 #

1. 在Jenkins中执行clean package命令，确保构建是干净的；
2. 构建完成后，查看Maven日志，确认JAR will be empty警告消失；
3. 解压target目录下的Jar包，检查是否包含dist目录下的资源文件。

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