Docker容器中Maven忽略本地仓库问题求助

我有一个Maven项目，包含多个存放在私有仓库的自定义依赖，现在要基于Maven镜像构建Docker镜像，把这些依赖预加载到本地Maven仓库里。

Dockerfile #

FROM maven:3.8.6-openjdk-11-slim

COPY settings-docker.xml /usr/share/maven/ref/
COPY bom.xml /tmp

RUN mvn -B -f /tmp/bom.xml -s /usr/share/maven/ref/settings-docker.xml dependency:resolve

settings-docker.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
                      https://maven.apache.org/xsd/settings-1.0.0.xsd">
    <localRepository>/usr/share/maven/ref/repository</localRepository>

    <mirrors>
        <mirror>
            <id>Mirror of Private Repo</id>
            <mirrorOf>Private Repo</mirrorOf>
            <name>allows http</name>
            <url>http://here.it.is/repository/</url>
        </mirror>
    </mirrors>
</settings>

bom.xml #

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

    <modelVersion>4.0.0</modelVersion>
    <groupId>org.myproject</groupId>
    <artifactId>bom</artifactId>
    <packaging>pom</packaging>
    <version>1.0</version>

    <repositories>
        <repository>
            <id>Private Repo</id>
            <url>http://here.it.is/repository/</url>
        </repository>
    </repositories>

    <dependencies>
        <dependency>
            <groupId>codec</groupId>
            <artifactId>codec</artifactId>
            <version>1.10.0.</version>
        </dependency>
    </dependencies>

</project>

我已经按照Maven官方镜像的说明，用/usr/share/maven/ref/repository目录预加载依赖。镜像构建成功后，启动容器能在/usr/share/maven/ref/repository和/root/.m2/repository里看到依赖，但运行Maven时还是会尝试连接私有仓库。这是Maven的特性导致，还是Maven忽略了本地仓库？

这是Maven的正常特性，并非忽略本地仓库，核心原因有两点：

1. 依赖元数据校验
   Maven默认会检查本地仓库中依赖的元数据（如maven-metadata.xml）是否与远程仓库同步，即便本地已有完整的jar包，也会尝试连接远程仓库确认版本的有效性。如果是离线环境，必须显式启用离线模式。

2. 配置文件不一致
   预加载依赖时使用的是指定的settings-docker.xml，但后续运行Maven时，若未指定该配置文件，Maven会默认使用/root/.m2/settings.xml。如果默认配置的本地仓库或镜像设置与预加载时不一致，就会触发远程仓库的检查请求。

对应的解决办法：

• 启用离线模式：运行Maven命令时添加-o参数，强制Maven仅使用本地仓库，不再连接远程仓库，示例：

  mvn -o clean package
  

• 统一配置文件：确保后续运行Maven时使用和预加载依赖相同的配置。可以把settings-docker.xml复制到/root/.m2/settings.xml，或者运行命令时通过-s参数指定配置文件，示例：

  mvn -s /usr/share/maven/ref/settings-docker.xml clean package
  

• 优化Docker构建步骤：在Dockerfile中直接将配置文件复制到默认路径，避免后续重复指定参数，修改后的Dockerfile片段：

  COPY settings-docker.xml /root/.m2/settings.xml
  

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