maven-dependency-plugin 3.1.2 unpack目标杜绝覆盖已有文件的配置咨询

你遇到的是 maven-dependency-plugin 3.1.2 版本的参数优先级逻辑问题，现有配置未生效的核心原因有两点：

• 控制覆盖行为的总开关参数overWrite，你只在单个artifactItem节点内配置，未在插件全局configuration层级显式声明。3.1.2版本中，如果全局层级的overWrite参数保持默认空值，插件会直接忽略所有artifactItem内配置的覆盖规则，触发兜底判断逻辑：只要检测到目标路径下的文件和压缩包内的对应文件在大小、权限、二进制内容上存在差异，就会强制覆盖已存在的文件。
• 你配置的overWriteIfNewer、overWriteReleases、overWriteSnapshots三个参数，本身是overWrite=true场景下的细分控制规则，不具备独立禁止覆盖的效力。只有当总开关overWrite被显式设置为false时，插件才会跳过所有已存在文件的写入逻辑，完全不触发覆盖判断流程。

直接在插件的全局configuration块中，补上缺失的全局overWrite=false配置即可，完整配置如下：

<plugin>
  <artifactId>maven-dependency-plugin</artifactId>
  <version>3.1.2</version>
  <executions>
    <execution>
      <id>unpack-zip-files</id>
      <phase>generate-test-resources</phase>
      <goals>
        <goal>unpack</goal>
      </goals>
      <configuration>
        <!-- 全局总开关：显式声明禁止覆盖所有已存在文件 -->
        <overWrite>false</overWrite>
        <artifactItems>
          <artifactItem>
            <groupId>com.foo</groupId>
            <artifactId>bar</artifactId>
            <version>${foobar.version}</version>
            <type>zip</type>
            <classifier>exe-archive</classifier>
            <outputDirectory>${project.build.directory}/lib</outputDirectory>
            <includes>**/*.exe</includes>
          </artifactItem>
        </artifactItems>
        <overWriteIfNewer>false</overWriteIfNewer>
        <overWriteReleases>false</overWriteReleases>
        <overWriteSnapshots>false</overWriteSnapshots>
      </configuration>
    </execution>
  </executions>
</plugin>

配置完成后，插件的判断逻辑将完全匹配你的预期：

• 只要${project.build.directory}/lib目录下已经存在同名的fooBar.exe文件，不管该文件的大小、权限、修改时间和压缩包内的文件有多大差异，插件都会直接跳过该文件的解压步骤，不会对已存在的文件做任何修改
• 只有当目标路径下不存在同名文件时，插件才会从压缩包内解压对应文件到目标目录
• 你之前遇到的“提前放置的特性分支构建产物被主干版本snapshot文件覆盖”的问题会完全消失，执行mvn install前后，fooBar.exe的md5校验值将保持一致

• 不需要在单个artifactItem节点内重复配置overWrite=false，全局层级的配置会覆盖所有子项的默认值，重复配置不会带来额外效果，反而容易在后续插件版本升级时出现参数解析冲突
• 3.1.2版本的该逻辑问题在后续新版本中已被修复，但全局显式设置overWrite=false依然是最稳妥的禁止已存在文件被覆盖的配置方式

内容的提问来源于stack exchange，提问作者Amedee Van Gasse