如何让Jenkins使用本地M2仓库？离线模式依赖问题排查

有两种常用的方法可以让Jenkins用上你的本地M2仓库，你可以根据实际情况选择：

方法一：通过Maven Settings文件配置 #

• 登录Jenkins后台，点击左侧菜单的Manage Jenkins，选择Global Tool Configuration
• 找到Maven板块，若还未配置Maven安装，点击Add Maven，给它命名（比如「本地Maven」），然后选择你本地Maven的安装路径（例如/usr/local/maven或C:\Program Files\Apache\maven）
• 在该Maven配置项下方，找到Settings file选项，选择「Provide settings file in the filesystem」，输入你本地Maven settings.xml的路径（通常在~/.m2/settings.xml或C:\Users\你的用户名\.m2\settings.xml）
• 保存配置即可。这个settings.xml里的<localRepository>标签已经指定了本地M2仓库路径，Jenkins会自动沿用该配置

方法二：直接设置Jenkins的环境变量 #

• 进入Jenkins的Manage Jenkins -> Configure System
• 滚动到Global properties板块，勾选「Environment variables」
• 点击Add，添加两个环境变量：
  • 变量名：M2_HOME，变量值填写你的本地Maven安装根目录
  • 变量名：MAVEN_OPTS，变量值填写-Dmaven.repo.local=/path/to/your/local/m2/repository（将路径替换为你实际的本地仓库路径，比如~/.m2/repository）
• 保存配置就完成了

这种情况基本是Jenkins使用的Maven仓库和你命令行的不一致，你可以通过以下几种方式排查：

方式一：从构建日志提取仓库信息 #

• 重新触发一次失败的构建，在构建日志里搜索「[INFO] Repositories:」或「Downloading from」关键词，日志会列出Jenkins当前Maven会话使用的所有仓库（包括本地和远程仓库）
• 你也可以在构建的Execute shell（Linux）或Execute Windows batch command（Windows）步骤中，添加一行命令：mvn help:effective-settings，执行后日志会输出完整的有效配置，其中包含<localRepository>和<repositories>的详细内容

方式二：查看Jenkins关联的Maven Settings文件 #

• 进入Jenkins的Manage Jenkins -> Global Tool Configuration，找到当前使用的Maven安装配置，查看它指定的Settings文件路径
• 直接打开该Settings文件，查看<localRepository>和<repositories>的配置，就能明确Jenkins检查依赖用的仓库
• 如果未指定自定义Settings文件，Jenkins会使用Maven默认Settings（通常在M2_HOME/conf/settings.xml），或者Jenkins运行用户目录下的.m2/settings.xml（注意：Jenkins的运行用户可能和你命令行用户不同，比如Linux下可能是jenkins用户，它的.m2目录在/var/lib/jenkins/.m2/）

方式三：检查Jenkins运行用户的M2目录 #

• 若使用Linux系统，可以登录服务器，切换到Jenkins运行用户（比如sudo su jenkins），查看~/.m2/目录下的settings.xml和repository文件夹，和你自己用户的.m2目录对比，就能发现差异
• Windows系统中，Jenkins通常运行在「Local System」账户下，它的默认M2目录在C:\Windows\System32\config\systemprofile\.m2\，你可以前往此处检查配置和仓库内容

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