Jenkins未使用本地Maven仓库的配置方案咨询

我之前也踩过这个一模一样的坑！Jenkins任务默认是用它自己的系统账户运行的，根本不会去读你Windows个人用户目录下的.m2仓库，这就是问题的核心。下面给你一步步解决的办法，亲测有效：

1. 先搞清楚Jenkins用的是哪个用户身份 #

Jenkins在Windows上作为服务运行时，默认用的是本地系统账户或者专门的jenkins账户，不是你日常登录的那个用户。要确认这一点：

• 按下Win+R输入services.msc打开服务管理器
• 找到Jenkins服务，右键→属性→切换到「登录」标签页，查看当前使用的账户

不同账户对应的默认.m2路径不一样：

• 本地系统账户：C:\Windows\System32\config\systemprofile\.m2
• 自定义Jenkins账户：C:\Users\你的Jenkins账户名\.m2

2. 把你的本地Maven仓库同步到Jenkins用户目录 #

最直接的办法是把你个人用户下的.m2仓库复制到Jenkins运行用户的目录下：

• 找到你自己的.m2目录（比如C:\Users\你的用户名\.m2）
• 复制整个文件夹到步骤1查到的Jenkins用户目录下，覆盖或替换原有的.m2文件夹（如果有的话）

3. 配置Jenkins全局Maven设置（推荐） #

为了让Jenkins稳定使用你的Maven配置，建议统一管理settings.xml：

• 登录Jenkins后台，进入「Manage Jenkins」→「Global Tool Configuration」
• 找到Maven配置区域：
  • 如果你用的是系统安装的Maven，在「Maven installations」里找到对应的Maven，设置「Settings file」为Jenkins用户目录下的settings.xml路径（比如C:\Windows\System32\config\systemprofile\.m2\settings.xml）
  • 或者点击「Add Maven Settings」，上传你自己的settings.xml文件，之后在任务中指定使用这个配置

4. 任务级临时指定仓库路径（应急方案） #

如果上面的配置暂时没生效，可以直接在Jenkins任务的构建命令里强制指定仓库路径：
在「Build」步骤的Maven命令中添加参数：

mvn clean package -Dmaven.repo.local=C:\Users\你的用户名\.m2\repository

这样Jenkins会直接读取你指定的这个本地仓库，跳过默认的用户上下文限制。

5. 检查权限是否足够 #

别忘了给Jenkins运行用户分配仓库目录的读取权限：

• 右键你的本地Maven仓库目录（比如C:\Users\你的用户名\.m2\repository）→属性→「安全」标签页
• 点击「编辑」→「添加」，输入Jenkins运行的账户名，给它分配「读取和执行」「列出文件夹内容」「读取」权限，保存即可

内容的提问来源于stack exchange，提问作者r-developer