Nexus私有仓库搭建与本地库迁移实践

1. 为什么需要将本地库导入Nexus

在企业级开发环境中，依赖管理是个绕不开的话题。想象一下：你团队内部开发了十几个公共组件库，每个项目都要引用这些组件。如果每次都从本地路径引用，不仅协作困难，版本管理更是一团乱麻。这就是我们需要搭建Nexus私有仓库的典型场景。

上周我帮一个金融项目做架构升级，就遇到了这样的痛点：他们原先通过共享文件夹管理jar包，结果不同项目引用的组件版本混乱，导致生产环境出现了接口不兼容的严重事故。将本地组件库统一迁移到Nexus后，不仅实现了版本控制，还能通过制品晋级流程确保稳定性。

2. 环境准备与工具选型

2.1 Nexus服务部署

建议使用Nexus 3.x版本，它对Maven、npm、Docker等多种格式的支持更完善。以下是快速搭建步骤：

bash复制# 使用Docker部署（推荐）
docker run -d -p 8081:8081 --name nexus sonatype/nexus3

# 等待约2分钟初始化后访问
http://localhost:8081

首次登录使用默认账号admin，密码在容器内/nexus-data/admin.password文件中。记得在Settings > Security中修改密码并创建专属用户。

2.2 本地库整理规范

在导入前需要对本地仓库进行标准化整理：

• 按groupId/artifactId/version三级目录结构组织
• 每个artifact必须包含pom文件和主构件（jar/war等）
• 建议命名规范：
  • SNAPSHOT版本：组件名-1.0.0-20230720.083214-1.jar
  • RELEASE版本：组件名-1.0.0.jar

重要提示：提前用mvn dependency:tree检查依赖关系，避免漏传间接依赖

3. 手动上传方案详解

3.1 控制台上传步骤

1. 登录Nexus控制台，进入对应仓库（如maven-releases）
2. 点击"Upload"按钮，选择本地文件
3. 填写GAV坐标（GroupId、ArtifactId、Version）
4. 勾选"Generate a POM file"或上传已有pom.xml
   5