Maven：依赖管理就像乐高拼装的艺术

🏗️ 第一章：Maven是高级乐高玩家

🔍 依赖管理的基本单元

<!-- 每个依赖就是一个乐高零件 -->
<dependency>
    <groupId>com.lego</groupId>    <!-- 零件系列 -->
    <artifactId>engine</artifactId> <!-- 具体零件 -->
    <version>2.0</version>         <!-- 零件版本 -->
    <scope>runtime</scope>         <!-- 使用场景 -->
</dependency>

乐高 vs Maven 类比表：

💡 小剧场：

当你在pom里加依赖时，Maven就像个乐高管家：

"主人要的’发动机2.0’，我从中央仓库（乐高官网）给您下载~

如果缺零件，我还会去您配置的私服（定制商店）找找！"

🧩 第二章：多模块项目——乐高巨舰组装术

🌟 为什么要拆分模块？

• 问题场景：单模块项目变成"一锅乱炖"

monolith-project/
├── src/
│   ├── main/
│   │   ├── java/  # 所有代码混在一起
│   │   └── resources/
└── pom.xml        # 依赖列表长达200行！

• 解决方案：按功能拆分成"乐高模块"

modular-project/
├── api/           # 接口定义
├── core/          # 核心逻辑
├── web/           # 控制器
└── pom.xml        # 父POM管理公共配置

🛠️ 父子POM配置示范

父pom.xml（相当于乐高底板）：

<modules>
<module>api</module>
<module>core</module>
<module>web</module>
</modules>

<!-- 统一管理依赖版本 -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.7.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

子模块pom.xml（特定零件包）：

<!-- 继承父POM -->
<parent>
    <groupId>com.mycompany</groupId>
    <artifactId>parent</artifactId>
    <version>1.0</version>
</parent>

<!-- 声明自己的依赖 -->
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <!-- 无需写版本，父POM已管理 -->
    </dependency>
</dependencies>

拆分技巧：

• 按职责划分：比如order-service, user-service
• 按架构分层：比如model, repository, service
• 黄金法则：一个模块的变更不应频繁影响其他模块

⚔️ 第三章：依赖冲突——乐高零件不兼容事件

🔥 经典冲突场景

[WARNING] Found conflict:
com.google.guava:guava:jar:
20.0 (compile) vs 30.0-jre (compile)

🛡️ 三大解决武器

武器1：依赖排除（精准拆除）

<dependency>
  <groupId>org.apache.hadoop</groupId>
  <artifactId>hadoop-common</artifactId>
  <exclusions>
    <exclusion>  <!-- 排除冲突零件 -->
      <groupId>com.google.guava</groupId>
      <artifactId>guava</artifactId>
    </exclusion>
  </exclusions>
</dependency>

武器2：依赖锁定（版本固化）

<!-- 在dependencyManagement中锁定版本 -->
<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>31.1-jre</version>
</dependency>

武器3：mvn命令分析（侦探工具）

# 查看依赖树
mvn dependency:tree

# 分析冲突
mvn dependency:analyze-duplicate

# 终极武器：图形化展示
mvn dependency:tree -DoutputFile=deps.txt

💡 冲突解决黄金法则：

“就近优先” → Maven会选择依赖树中离项目更近的版本

🏭 第四章：私服搭建——企业级乐高仓库

🤔 为什么需要私服？

• 加速构建（缓存常用依赖）
• 托管内部二方库
• 安全隔离（避免直连外网）

🚧 Nexus私服踩坑记录

坑1：默认admin密码在哪？

# 安装后第一次启动时生成
nexus-install-dir/sonatype-work/nexus3/admin.password

坑2：上传jar返回400错误

# 必须指定repository参数
curl -u admin:password --upload-file my.jar \
http://nexus:8081/repository/maven-releases/com/example/my/1.0/my-1.0.jar

坑3：代理中央仓库慢

# 修改nexus/etc/nexus-default.properties
nexus.remote.storage.connection.timeout=60000
nexus.remote.storage.connection.max.total=200

🌟 最佳实践配置

<!-- settings.xml 配置私服镜像 -->
<mirror>
    <id>nexus</id>
    <url>http://nexus:8081/repository/maven-public/</url>
    <mirrorOf>*</mirrorOf>
</mirror>

🧰 第五章：Maven高级工具包

🛠️ 常用插件推荐

💡 冷知识：依赖范围(scope)详解

<!-- 像选择乐高使用场景 -->
<dependency>
    <scope>compile</scope>   <!-- 默认值，全程参与 -->
    <scope>provided</scope>  <!-- 容器会提供，如Servlet API -->
    <scope>runtime</scope>   <!-- 仅运行时需要，如JDBC驱动 -->
    <scope>test</scope>      <!-- 只在测试用，如JUnit -->
</dependency>

🌟 终极心法

"好的Maven项目应该像乐高大师的作品：

• 模块化：每个零件各司其职
• 低耦合：更换零件不影响整体
• 可追溯：版本明确不混乱"

👉 行动清单：

• 用mvn dependency:tree检查你的项目依赖树
• 尝试将一个单体项目拆分成多模块
• 搭建本地Nexus私服体验企业级管理

记住：依赖管理不是玄学，而是精确的积木拼装艺术。现在就去优化你的"乐高作品"吧！ 🧱✨