容器中HOME=/时Maven忽略/.m2仓库的问题求助

问题背景 #

• 运行环境：基于Jenkins脚本化流水线，使用docker.image(...).inside(...) { ... }语法执行Maven命令
• 配置情况：主机已填充完整的.m2目录映射到容器根目录/，容器内HOME环境变量设为/，可正常访问/.m2/repository
• 异常表现：
  • 执行mvn -X ...时，日志显示Maven尝试使用路径：

    [DEBUG] Using local repository at ...@2/?/.m2/repository
    

    路径包含@2后缀和未知?字符，该路径不存在，但末尾带@2的目录是容器当前真实存在的工作目录
  • Maven未使用映射的/.m2/repository，仍重复下载本地已有的构件

解决方案 #

1. 显式指定本地仓库路径 #

执行Maven命令时通过-Dmaven.repo.local参数直接指定仓库路径，避免路径解析干扰：

mvn -Dmaven.repo.local=/.m2/repository clean install

2. 修正容器工作目录 #

Jenkins Docker插件默认挂载的工作目录可能带有特殊后缀（如@2），导致Maven路径解析异常，可显式指定容器工作目录为/：

docker.image('你的Maven镜像').inside('-w /') {
    sh 'mvn clean install'
}

3. 强制设置HOME环境变量 #

在inside块中显式声明HOME为/，确保Maven识别~/.m2指向/.m2：

docker.image('你的Maven镜像').inside {
    env.HOME = '/'
    sh 'mvn clean install'
}

4. 配置settings.xml指定仓库 #

在容器的/.m2/settings.xml中明确配置本地仓库位置：

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <localRepository>/.m2/repository</localRepository>
</settings>

内容的提问来源于stack exchange，提问作者David M. Karr