今天在工作時遇到一個測試環境maven打包失敗的問題。一開始的時候jenkins只顯示了打包失敗，沒有其他的資訊展示出來，在將專案拉取到本地之後，專案又可以完好地啟動，於是判斷可能是maven打包時出錯，於是終端進入對應目錄之後，輸入以下命令：

mvn package -U -Denv=pre -DskipTests

果然，build failed。

現場失敗資訊如下：

官網對它的介紹是：

The Resources Plugin handles the copying of project resources to the output directory. There are two different kinds of resources: main resources and test resources. The difference is that the main resources are the resources associated to the main source code while the test resources are associated to the test source code.

查看了官方的介紹之後，我對它的總結如下：

我們可以使用maven-resource-plugin在構建專案時對pom檔案進行動態的變數替換，比如：

<project>
    ...
    <properties>
        <your.name>world</your.name>
    </properties>
    ...
</project>

可以結合filter來讀取資原始檔中的變數設定，以此來進行變數的動態替換。

...
<filters>
  <filter>my-filter-values.properties</filter>
</filters>
...
 

properties檔案中可以這麼存：

your.name=hello

然後maven在進行打包的過程中會將filter中的檔案內容和所有resource中的內容進行全部替換。這樣的話我們可以在專案中定義一些特定的值，並且在打包過程中進行動態替換。需要替換的資源是這麼指定的：

...
<resources>
   <resource>
      <directory>src/main/resources</directory>
      <filtering>true</filtering>
   </resource>
</resources>
...
 

官方在這裡對其進行了說明：

Warning: Do not filter files with binary content like images! This will most likely result in corrupt output.

If you have both text files and binary files as resources it is recommended to have two separated folders. One folder src/main/resources (default) for the resources which are not filtered and another folder src/main/resources-filtered for the resources which are filtered.

也就是說指定資源範圍內如果存在二進位制檔案和圖片的話可能會有檔案在進行過濾替換的過程中被損壞。

看到這裡，我翻看了一下專案提交日誌，發現有同事在最近的提交中新增了ttf檔案，並且正好在我們的專案過濾替換範圍之內。

看來問題可能出現在這了。按照官方文件的指示，繼續檢視相關說明。
官方給的方案如下：

<project>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-resources-plugin</artifactId>
        <version>3.0.2</version>
        <configuration>
          ...
          <nonFilteredFileExtensions>
            <nonFilteredFileExtension>pdf</nonFilteredFileExtension>
            <nonFilteredFileExtension>swf</nonFilteredFileExtension>
          </nonFilteredFileExtensions>
          ...
        </configuration>
      </plugin>
    </plugins>
    ...
  </build>
  ...
</project>

看完語法之後發現，其實設定過濾和上面的include域exclude用法類似。官方說明如下：

When specifying a resource directory, every file within that directory may not be used. Thus, we may have to specify only the files that we want to include or specify the files that we want to exclude.

To include a resource, we only need to add an element.

And to exclude a resource, we only need to add an element.

For example, we can have both and elements. For example, if we want to include all text files that does not contain the word “test” in their filename.

<project>
  ...
  <name>My Resources Plugin Practice Project</name>
  ...
  <build>
    ...
    <resources>
      <resource>
        <directory>src/my-resources</directory>
        <includes>
          <include>**/*.txt</include>
        </includes>
        <excludes>
          <exclude>**/*test*.*</exclude>
        </excludes>
      </resource>
      ...
    </resources>
    ...
  </build>
  ...
</project>

看來解決辦法就在這兒了。

原有的資原始檔設定如上所示，經過修改之後，變更如下：

再次打包試一下：

完美。分享一下，挖坑填坑是個技術活。