离线环境下Artifactory本地Maven仓库配置及依赖上传指引

一、仓库创建选项说明 #

• 处理发布版：必须勾选，如果你需要存储正式发布的稳定版本依赖（比如xxx-1.0.jar这类带固定版本号的包）。发布版一旦上传后通常不会变更，Artifactory会严格保证版本唯一性，避免构建出现不可预期的问题。
• 处理快照版：按需勾选。如果你的项目依赖开发中的快照版本（比如xxx-1.0-SNAPSHOT.jar），就需要勾选——快照版允许重复上传同版本的更新包，适配开发阶段的迭代需求；如果只用到稳定发布版，可不勾选。
• 抑制POM一致性检查：不建议勾选，除非你明确知道上传的依赖存在POM与jar包版本不一致的情况（比如手动修改过POM）。正常情况下这个检查能避免依赖版本混乱，保证构建稳定性，离线环境上传正规依赖时完全没必要关闭。

二、手动上传依赖的简化操作 #

1. Web UI单/少量上传 #

• 进入你创建的本地Maven仓库，点击页面上的「上传」按钮
• 选择要上传的jar包和对应POM文件，务必保证两者版本一致
• 在「目标路径」中填写符合Maven规范的路径：groupId/artifactId/version/（例如org/springframework/spring-core/5.3.20/），Artifactory会自动识别并生成正确的仓库元数据

2. Maven命令批量上传（适合大量依赖） #

• 先在有网络的机器上，通过mvn dependency:copy-dependencies或正常构建项目，把所需依赖下载到本地Maven仓库
• 把本地仓库的整个目录复制到离线服务器上
• 编写简单脚本批量遍历本地仓库的jar和pom文件，执行以下命令完成上传（提前在settings.xml中配置好Artifactory的仓库ID和地址）：

  mvn deploy:deploy-file -Durl=http://你的Artifactory地址/local-maven-repo -DrepositoryId=local-repo-id -Dfile=/path/to/dependency.jar -DpomFile=/path/to/dependency.pom
  

三、构建中使用该仓库的配置 #

推荐修改全局settings.xml，让所有项目共用配置，简化操作：

<settings>
  <!-- 镜像配置，让所有依赖请求都走本地Artifactory -->
  <mirrors>
    <mirror>
      <id>local-artifactory</id>
      <mirrorOf>*</mirrorOf>
      <url>http://你的Artifactory地址/local-maven-repo</url>
    </mirror>
  </mirrors>

  <!-- 激活本地仓库配置 -->
  <profiles>
    <profile>
      <id>local-repo</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <repositories>
        <repository>
          <id>local-artifactory</id>
          <url>http://你的Artifactory地址/local-maven-repo</url>
          <releases>
            <enabled>true</enabled>
          </releases>
          <snapshots>
            <enabled>true</enabled>
          </snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>
</settings>

如果只需要单个项目使用，直接在项目的pom.xml中添加仓库配置即可：

<repositories>
  <repository>
    <id>local-artifactory</id>
    <url>http://你的Artifactory地址/local-maven-repo</url>
    <releases>
      <enabled>true</enabled>
    </releases>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
  </repository>
</repositories>

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