如何配置Maven仅在文件变更时执行文件复制操作

我之前开发Java Web应用时也碰到过一模一样的困扰——每次Maven执行复制操作，哪怕配置文件根本没改，Tomcat也会因为文件被“触碰”而重启，简直太影响开发节奏了。针对你的问题，我有两个比较实用的解决方案，你可以根据自己的偏好选择：

方案一：改用maven-resources-plugin（推荐） #

copy-rename-maven-plugin本身确实没有内置的增量复制逻辑，但maven-resources-plugin的copy-resources目标默认就支持基于文件修改时间的增量复制——只有当源文件的修改时间晚于目标文件时，才会执行覆盖操作，完美解决你的痛点。

你只需要在pom.xml里替换原来的插件配置，改成下面这样：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-resources-plugin</artifactId>
      <version>3.3.1</version> <!-- 用最新稳定版即可 -->
      <executions>
        <execution>
          <id>copy-tomcat-configs</id>
          <phase>process-resources</phase>
          <goals>
            <goal>copy-resources</goal>
          </goals>
          <configuration>
            <outputDirectory>${tomcat.home}/conf</outputDirectory> <!-- 你的Tomcat配置目录 -->
            <resources>
              <resource>
                <directory>${project.basedir}/src/main/tomcat-conf</directory> <!-- 本地配置文件所在目录 -->
                <includes>
                  <include>context.xml</include>
                  <include>server.xml</include>
                  <!-- 加上你需要复制的其他配置文件 -->
                </includes>
              </resource>
            </resources>
            <overwrite>true</overwrite> <!-- 开启覆盖，但插件只会在源更新时执行 -->
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

这个配置的核心逻辑是：Maven会自动对比源文件和目标文件的最后修改时间，只有源文件确实更新了，才会复制替换目标文件，完全不会触发无意义的文件触碰，自然也就不会导致Tomcat重启了。

方案二：用maven-antrun-plugin结合Ant的增量复制 #

如果你坚持想用原来的插件思路，或者需要更灵活的自定义逻辑，可以借助maven-antrun-plugin调用Ant的copy任务——Ant的copy支持uptodate属性，能精准控制只复制更新过的文件。

配置示例如下：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-antrun-plugin</artifactId>
      <version>3.1.0</version>
      <executions>
        <execution>
          <id>copy-tomcat-configs</id>
          <phase>process-resources</phase>
          <goals>
            <goal>run</goal>
          </goals>
          <configuration>
            <target>
              <copy todir="${tomcat.home}/conf" overwrite="true" uptodate="true">
                <fileset dir="${project.basedir}/src/main/tomcat-conf">
                  <include name="context.xml"/>
                  <include name="server.xml"/>
                </fileset>
                <mapper type="identity"/>
              </copy>
            </target>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

这里的uptodate="true"就是关键，它会让Ant只复制那些源文件修改时间比目标文件新的文件，和方案一的效果一致，但配置相对繁琐一点。

额外注意事项 #

• 确保你配置的${tomcat.home}是正确的本地Tomcat路径，避免复制到错误的目录；
• 如果偶尔出现复制不生效的情况，可以手动删除Tomcat配置目录里的目标文件，让Maven重新复制一次；
• 开发过程中尽量不要直接修改Tomcat目录下的配置文件，所有修改都在本地源目录进行，这样Maven才能正确检测到变更。

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