Maven自动复制依赖到项目结构的原因及禁用方法

算力阿峰

2026-9-3

问题触发原因

Zulu 11 JDK和该异常行为无关联，JDK仅作为Maven运行环境，不会修改依赖存储逻辑。Maven核心程序默认不会主动将依赖复制到项目根目录，该行为是绑定到Maven生命周期的插件执行导致的，结合你提供的POM，常见触发原因如下：

存在maven-dependency-plugin的copy-dependencies目标被绑定到了compile、process-resources、package等常用生命周期阶段，且配置中错误将输出目录outputDirectory指向了项目根目录${project.basedir}。该目标的默认逻辑就是将项目所有直接、传递依赖复制到指定路径，只要执行对应生命周期的Maven命令就会自动触发复制。
你贴出的POM中没有显式配置该插件，但配置可能来自全局settings.xml、Maven安装目录下的全局配置文件，或是你执行命令时携带了隐式参数。你配置的spring-boot-maven-plugin默认所有执行目标的输出都在target目录下，不会触发根目录的依赖复制，可以排除。
部分IDE的Maven集成插件开启了依赖自动导出功能，在项目刷新、导入时会自动复制依赖到项目目录，但这类场景下依赖通常会存放在单独的lib文件夹中，不会直接散落在项目根目录。

排查与禁用方法

先定位触发源：执行带debug日志的编译命令，在控制台输出中搜索copy-dependencies关键字，即可直接定位到执行复制操作的插件、绑定的生命周期阶段，以及配置的来源位置：
```
mvn -X compile
```

也可以生成当前项目实际生效的完整POM文件，排查所有插件的最终配置：

mvn help:effective-pom > effective-pom.xml

打开生成的effective-pom.xml文件，搜索maven-dependency-plugin节点，如果看到如下结构的配置，就是问题根源：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-dependency-plugin</artifactId>
  <executions>
    <execution>
      <id>copy-dependencies</id>
      <phase>compile</phase>
      <goals>
        <goal>copy-dependencies</goal>
      </goals>
      <configuration>
        <!-- 配置为项目根目录时就会触发异常复制 -->
        <outputDirectory>${project.basedir}</outputDirectory>
      </configuration>
    </execution>
  </executions>
</plugin>

永久禁用方案：
- 如果配置来自项目POM文件：直接删除该插件的执行配置即可；如果确实需要复制依赖用于打包分发，把outputDirectory修改为${project.build.directory}/lib即可，输出会被归集到target目录下，不会污染项目根目录。
- 如果配置来自Maven全局配置或用户目录下的settings.xml：找到对应配置文件，移除该插件的绑定配置即可。
- 如果是IDE功能触发：进入IDE的Maven设置页，关闭「同步时导出依赖到项目目录」类的开关即可。
临时跳过方案：单次执行Maven命令时如果不想触发依赖复制，可以添加参数跳过该插件的执行：
```
mvn compile -Dmdep.skip=true
```

注：本地.m2目录是Maven的默认本地仓库，所有项目的依赖都会统一下载到该目录复用，正常开发流程下完全不需要额外复制依赖到项目目录，多余的复制操作只会占用磁盘空间、拖慢构建速度。

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