在日常的软件开发工作中，很多时候我们会遇到没有网络或者网络受限的情况。这时候，如果项目的构建依赖于网络去下载各种库和插件，那可就麻烦了。好在，Maven 有离线模式可以帮我们解决这个问题。接下来，咱们就深入剖析一下 Maven 的离线模式，看看在无网络或受限环境下怎么进行高效构建。

一、Maven 离线模式是啥

Maven 是一个非常流行的项目管理和构建自动化工具，它能帮我们管理项目里的依赖、构建流程这些事儿。通常情况下，当我们运行 Maven 命令时，它会到远程仓库去下载项目所需要的依赖。但是在离线模式下，Maven 就不会去远程仓库下载东西了，而是直接从本地仓库里找需要的依赖。

举个例子，就好像我们去超市买菜。正常情况我们会去大超市，那里啥菜都有。但要是超市关门了，我们就只能从自家冰箱里拿之前囤好的菜来做饭。这个冰箱就相当于本地仓库，大超市就是远程仓库。

二、为啥要用 Maven 离线模式

应用场景

  1. 无网络环境：在一些地方，比如飞机上、地下室，或者保密性要求高的场所，没有网络连接。这时候如果要继续进行项目构建，就只能用离线模式了。
  2. 网络受限：有些公司的网络限制很多，对于外部仓库的访问有限制。为了保证项目能正常构建，就可以先把依赖下载到本地，然后用离线模式。
  3. 节省时间：下载依赖有时候会很慢，尤其是在网络不好的时候。用离线模式就不用等下载了，能直接从本地仓库拿东西，构建速度会快很多。

技术优缺点

优点

  • 稳定可靠：不受网络状况影响，不会因为网络波动、中断而导致构建失败。
  • 节省时间和带宽：不需要每次构建都去下载依赖，节省了时间和网络带宽。

缺点

  • 依赖更新不及时：本地仓库的依赖不会自动更新，如果有新的版本，需要手动更新本地仓库。
  • 初始配置麻烦：要提前把所有需要的依赖下载到本地仓库，配置起来比较麻烦。

注意事项

  • 提前规划：在使用离线模式之前，要确保本地仓库里有项目所需的所有依赖。可以先在有网络的环境下，运行 mvn dependency:go-offline 命令把依赖下载到本地。
  • 依赖版本管理：要注意本地仓库里依赖的版本，避免版本不兼容的问题。

三、怎么开启 Maven 离线模式

命令行方式

在执行 Maven 命令时，加上 -o 或者 --offline 参数就可以开启离线模式了。

技术栈名称：Java

# 开启离线模式，执行 mvn clean install 命令
mvn -o clean install
# 上面这行命令的意思是，以离线模式对项目进行清理和安装操作

修改 settings.xml 文件

我们可以修改 Maven 的 settings.xml 文件，让它默认使用离线模式。找到 settings.xml 文件（一般在 Maven 安装目录的 conf 文件夹下），在 <settings> 标签里添加 <offline>true</offline>。

<settings>
    <!-- 开启离线模式 -->
    <offline>true</offline>
    <!-- 其他配置 -->
</settings>

这样配置之后，以后每次执行 Maven 命令时，都会默认使用离线模式。

四、在离线环境下准备依赖

手动下载依赖到本地仓库

有时候，我们可以手动把依赖下载下来，然后放到本地仓库对应的位置。Maven 的本地仓库默认在用户目录下的 .m2/repository 文件夹。

比如，我们要下载 org.apache.commons:commons-lang3:3.12.0 这个依赖。先去 Maven 中央仓库找到这个依赖的坐标，然后下载对应的 .jar 文件。接着把下载的 .jar 文件放到本地仓库对应的目录 ~/.m2/repository/org/apache/commons/commons-lang3/3.12.0 下。

使用 mvn dependency:go-offline 命令

这个命令可以帮助我们把项目所有的依赖都下载到本地仓库。在有网络的环境下，进入项目根目录，执行下面的命令：

技术栈名称：Java

# 下载项目所有依赖到本地仓库
mvn dependency:go-offline
# 这行命令会递归地下载项目及其插件所需的所有依赖

五、离线模式下的构件安装和部署

安装本地构件到本地仓库

在离线模式下，我们可能需要把自己开发的构件安装到本地仓库。可以使用 mvn install 命令。

技术栈名称：Java

# 把当前项目打包并安装到本地仓库
mvn -o install
# 即使在离线模式下，也能把项目打包成 jar 或 war 文件，并安装到本地仓库

部署构件到本地私服

如果有本地私服，我们可以把构件部署到私服上。使用 mvn deploy 命令：

技术栈名称：Java

# 把当前项目打包并部署到本地私服
mvn -o deploy
# 在离线模式下，将项目构件上传到本地私服上

六、处理离线模式下的依赖问题

依赖缺失问题

如果在离线模式下构建项目时，发现某个依赖缺失，就会构建失败。这时候需要检查本地仓库，看看这个依赖有没有正确下载。如果没有，回到有网络的环境下，使用 mvn dependency:go-offline 命令重新下载依赖。

依赖版本冲突问题

当项目里有多个依赖引用了同一个库的不同版本时，就会出现版本冲突问题。Maven 有自己的依赖调解机制，默认优先使用路径最短的依赖版本。我们也可以通过 <dependencyManagement> 标签来显式指定依赖的版本。

<project>
    <dependencyManagement>
        <dependencies>
            <!-- 显式指定 commons-lang3 的版本 -->
            <dependency>
                <groupId>org.apache.commons</groupId>
                <artifactId>commons-lang3</artifactId>
                <version>3.12.0</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
    <dependencies>
        <!-- 引入 commons-lang3 依赖 -->
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
        </dependency>
    </dependencies>
    <!-- 其他配置 -->
</project>

七、文章总结

Maven 的离线模式在无网络或受限环境下是非常实用的。它能让我们不受网络的限制，稳定、高效地进行项目构建。不过，在使用离线模式之前，要做好依赖的准备工作，确保本地仓库里有项目所需的所有依赖。同时，要注意依赖的版本管理，避免出现版本冲突等问题。

掌握了 Maven 离线模式的使用方法，我们就能在各种复杂的网络环境下，都能顺利地进行项目开发和构建啦。