Maven镜像生效是否必须配置repositories元素？

我们部署了企业级统一仓库管理器Nexus OSS，它既作为Central的镜像，也托管公司内部的releases和snapshots仓库，同时定义了包含所有仓库的public组。所有项目的pom.xml仅包含DistributionManagement元素，未配置repositories元素，因此希望在CI/CD代理的settings.xml中配置所需信息。

最初尝试仅配置mirror，将mirrorOf设为*，未定义profile：

<mirror>
    <id>nexus</id>
    <mirrorOf>*</mirrorOf>
    <url>https://nexusurl/nexus/repository/public/</url>
</mirror>

但构建时出现依赖无法找到的错误：

Failed to execute goal on project example-project: Could not resolve dependencies for project group:project:jar:version: Could not find artifact group2:project2:jar:version-SNAPSHOT -> [Help 1]

而使用包含以下配置的profile时则可正常构建：

<profile>
    <id>nexus</id>
    <repositories>
         <repository>
            <id>nexus</id>
            <name>nexus</name>
            <url>https://nexusurl/nexus/repository/public/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>true</enabled>
                <updatePolicy>always</updatePolicy>
            </snapshots>
        </repository>
    </repositories>
</profile>

镜像和仓库均使用Nexus OSS中的同一个组，无法理解为何两种配置结果不同。请问Maven是否必须配置repositories元素才能使镜像生效？是否因为没有仓库信息就无法应用镜像？

补充说明：并非所有依赖都会报错，主要是公司内部依赖，这些依赖已确认在Nexus OSS中存在，我们将其上传至releases/snapshots仓库，但从public组下载，这是否也会导致问题？

核心原因：Maven镜像的生效逻辑 #

Maven的镜像（mirror）本质是对已有仓库地址的替换，而非直接定义新的仓库源。也就是说，镜像配置需要有对应的原始仓库（无论是Maven默认的Central，还是自定义仓库）作为“目标”，才能发挥作用。

• 当只配置<mirrorOf>*</mirror>时，Maven会尝试替换所有已存在的仓库地址。但项目pom.xml未配置repositories，此时Maven只会加载默认的Central仓库——而默认Central对快照（SNAPSHOT）依赖是禁用状态的。
• 内部快照依赖需要从允许快照的仓库拉取，但默认Central不允许，所以即使镜像指向包含快照仓库的public组，Maven依然会遵循原始仓库（默认Central）的快照禁用规则，导致无法找到快照依赖。

为何配置profile后正常工作？ #

在profile中配置repositories时，显式定义了一个同时允许releases和snapshots的仓库。此时：

1. 这个自定义仓库成为Maven的依赖源之一
2. 镜像配置<mirrorOf>*</mirror>会替换该仓库的地址为public组地址
3. 关键是，自定义仓库的快照启用规则会被保留，Maven会允许从该镜像地址拉取快照依赖

关于内部依赖的补充说明 #

内部依赖上传到releases/snapshots仓库、从public组下载的流程本身没问题，Nexus的public组会聚合所有成员仓库的内容。问题出在Maven端的仓库规则，而非Nexus的组配置。

最终结论 #

• Maven不需要必须配置repositories才能让镜像生效，但镜像的行为会受原始仓库的配置规则（比如快照是否启用）影响。
• 只配置镜像时，因依赖默认Central的快照禁用规则，导致无法拉取内部快照依赖；配置profile中的repositories是为了提供一个允许快照的仓库源，让镜像替换后能正常拉取快照。

优化建议 #

可以不用在profile中配置完整的仓库地址，而是通过profile激活默认Central仓库的快照支持，同时保留镜像配置：

<profile>
    <id>enable-snapshots</id>
    <repositories>
        <repository>
            <id>central</id>
            <url>https://repo1.maven.org/maven2</url>
            <releases><enabled>true</enabled></releases>
            <snapshots><enabled>true</enabled></snapshots>
        </repository>
    </repositories>
</profile>

这样镜像会替换默认Central的地址为你的public组，同时启用快照支持，既简化配置又解决问题。

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