如何通过Maven CLI从自定义仓库下载指定构件到自定义目标路径（适配新版依赖插件）

阿华AIGC实验室

2026-4-2

核心解决方案：使用`dependency:copy`并指定自定义仓库

你遇到的问题核心是没有在dependency:copy命令中传入自定义仓库参数——新版插件完全支持从自定义仓库拉取构件，只是需要显式配置。以下是直接可用的跨平台命令：

# macOS/Linux 版本
mvn dependency:copy \
  -Dartifact="ace.contrib:ace:6.0.1:zip:vc9x32" \
  -DremoteRepositories="jboss-repo::default::https://repository.jboss.org" \
  -DoutputDirectory="./downloads" \
  -DartifactFilename="artifact.zip" \
  -Dtransitive=false

:: Windows 版本（换行符替换为^）
mvn dependency:copy ^
  -Dartifact="ace.contrib:ace:6.0.1:zip:vc9x32" ^
  -DremoteRepositories="jboss-repo::default::https://repository.jboss.org" ^
  -DoutputDirectory="./downloads" ^
  -DartifactFilename="artifact.zip" ^
  -Dtransitive=false

命令参数详解

每个参数的作用拆解，帮你彻底理解逻辑：

-Dartifact: 目标构件的坐标，格式为groupId:artifactId:version:packaging:classifier，和你之前使用的完全一致。
-DremoteRepositories: 自定义仓库配置（关键！之前你省略了这个参数），格式为仓库ID::仓库布局::仓库URL：
- 仓库ID：任意自定义名称（比如jboss-repo），仅用于标识；
- 仓库布局：Maven 2/3标准仓库填default即可；
- 仓库URL：你的自定义仓库地址。
  这一步解决了Maven只查中央仓库的问题，让它能找到你的私有/自定义构件。
-DoutputDirectory: 构件保存的目标目录，支持相对路径（如./downloads）或绝对路径，跨平台通用。
-DartifactFilename: 自定义下载后的文件名（比如artifact.zip），省略则使用构件默认文件名（如ace-6.0.1-vc9x32.zip）。
-Dtransitive=false: 禁止下载依赖的依赖，和你最初的需求匹配。

处理需要认证的自定义仓库

如果你的仓库需要用户名密码，推荐用临时Settings文件（避免密码暴露在命令历史中）：

创建临时配置文件temp-settings.xml：

<settings>
  <servers>
    <server>
      <id>jboss-repo</id> <!-- 必须和命令中的仓库ID完全一致 -->
      <username>你的用户名</username>
      <password>你的密码</password>
    </server>
  </servers>
</settings>

在命令中引用该文件：

mvn dependency:copy \
  -Dartifact="ace.contrib:ace:6.0.1:zip:vc9x32" \
  -DremoteRepositories="jboss-repo::default::https://repository.jboss.org" \
  -DoutputDirectory="./downloads" \
  -DartifactFilename="artifact.zip" \
  -Dtransitive=false \
  --settings temp-settings.xml

为什么之前的尝试失败？

你之前运行mvn dependency:copy时未指定自定义仓库，Maven默认仅查询中央仓库。即使本地缓存有该构件，Maven会验证缓存来源是否在当前允许的仓库列表中——由于自定义仓库不在列表内，它会拒绝使用缓存并报错。

验证成功的标志

执行命令后，你会看到类似日志，说明构件已成功下载并复制到指定路径：

[INFO] Copying ace.contrib:ace:zip:vc9x32:6.0.1 to ./downloads/artifact.zip
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------