Maven中如何仅在源文件存在时替换输出配置目录中的文件

copy-rename-maven-plugin本身没有内置的“仅当源存在时执行”的判断逻辑，不过可以结合maven-antrun-plugin实现这个需求，完美适配你本地修改配置但不纳入版本控制的场景。

实现步骤 #

1. 用maven-antrun-plugin检查源路径是否存在
   先通过ant任务检测本地配置文件/目录是否存在，设置一个标记属性：

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-antrun-plugin</artifactId>
       <version>3.1.0</version>
       <executions>
           <execution>
               <id>check-local-config-exists</id>
               <phase>process-resources</phase>
               <goals>
                   <goal>run</goal>
               </goals>
               <configuration>
                   <tasks>
                       <!-- 检查单个文件：替换为你的源文件路径 -->
                       <available file="${project.basedir}/src/main/resources-local/application.yml" property="local.config.exists"/>
                       <!-- 若要检查目录，替换为：
                       <available dir="${project.basedir}/src/main/resources-local" property="local.config.exists"/>
                       -->
                   </tasks>
               </configuration>
           </execution>
       </executions>
   </plugin>
   

2. 配置copy-rename-maven-plugin根据条件执行
   通过skip属性绑定上面的标记属性，仅当源存在时才执行复制：

   <plugin>
       <groupId>com.coderplus.maven.plugins</groupId>
       <artifactId>copy-rename-maven-plugin</artifactId>
       <version>1.0.1</version>
       <executions>
           <execution>
               <id>copy-local-config</id>
               <phase>process-resources</phase>
               <goals>
                   <goal>copy</goal>
               </goals>
               <configuration>
                   <!-- 源不存在时跳过任务 -->
                   <skip>${!local.config.exists}</skip>
                   <!-- 单个文件复制配置 -->
                   <sourceFile>${project.basedir}/src/main/resources-local/application.yml</sourceFile>
                   <destinationFile>${project.basedir}/target/classes/application.yml</destinationFile>
                   <!-- 目录复制配置（替换上面两行）：
                   <sourceDirectory>${project.basedir}/src/main/resources-local</sourceDirectory>
                   <destinationDirectory>${project.basedir}/target/classes</destinationDirectory>
                   -->
               </configuration>
           </execution>
       </executions>
   </plugin>
   

场景适配 #

• 将本地修改的配置放在src/main/resources-local（或自定义路径），并把这个路径添加到.gitignore中，避免提交到版本库
• 本地有该路径时，插件自动复制配置到编译目录，覆盖默认配置；无此路径时，直接使用项目自带的配置，完全不影响构建流程

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