为何Maven在GitLab构建时会查找不存在的SNAPSHOT版本？

问题根源 #

本地使用mvn package能正常解析[5,5.99]版本范围并获取Spring Core最新稳定版，但GitLab CI通过jf mvn构建时却不断尝试拉取不存在的SNAPSHOT版本，核心原因有三点：

1. 仓库配置差异
   本地Maven的settings.xml通常仅配置中央仓库，且默认关闭SNAPSHOT版本拉取；而GitLab Runner的配置可能接入了公司内部的Jfrog Artifactory仓库，该仓库同时允许拉取releases和snapshots，且Artifactory的版本元数据中存在错误的SNAPSHOT版本条目（例如同步异常、缓存残留），导致Maven误以为这些版本存在，进而尝试拉取。

2. Jfrog CLI的封装特性
   jf mvn并非原生Maven，它会自动注入Artifactory的仓库配置，覆盖原生Maven的默认设置。当Artifactory的版本索引包含不存在的SNAPSHOT版本时，Maven的版本解析器会优先尝试这些“更高版本”的SNAPSHOT，而非选择已存在的稳定版。

3. 版本范围解析逻辑触发
   [5,5.99]的范围包含所有5.x版本（直到5.99），Maven的版本解析器在遇到仓库中标记为“更新”的SNAPSHOT版本时，会优先尝试拉取，即使这些版本实际上不存在。

本地与GitLab Runner的核心差异 #

• 仓库权限与类型：本地仅访问中央仓库（无SNAPSHOT权限），Runner访问的Artifactory仓库同时允许releases和snapshots，且元数据异常。
• Maven执行环境：jf mvn封装了额外的仓库配置，而本地使用原生Maven，无附加配置干扰。
• 缓存状态：本地仓库已缓存稳定版依赖，而Runner每次构建可能使用全新仓库，触发完整的版本解析流程。

解决办法 #

1. 精准限定版本范围，排除SNAPSHOT #

修改pom.xml中的版本范围，明确排除SNAPSHOT版本：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>[5,5.99],!(5.*-SNAPSHOT)</version>
</dependency>

或者直接指定稳定版的上限，避免解析到不存在的版本：

<version>[5,5.3.34]</version>

2. 调整Artifactory仓库配置 #

修改GitLab Runner的settings.xml，将Artifactory的releases和snapshots仓库分开配置，仅开启releases仓库的访问：

<repositories>
    <repository>
        <id>artifactory-releases</id>
        <url>https://your-artifactory-url/libs-release</url>
        <releases><enabled>true</enabled></releases>
        <snapshots><enabled>false</enabled></snapshots>
    </repository>
</repositories>

3. 修复Artifactory元数据 #

登录Jfrog Artifactory，检查Spring Core的版本列表，删除不存在的SNAPSHOT版本条目，或触发中央仓库元数据的重新同步，确保Artifactory的版本信息与官方一致。

4. 命令行强制忽略SNAPSHOT #

在GitLab CI的构建命令中添加参数，强制Maven严格解析版本范围，仅选择已存在的稳定版：

jf mvn $MAVEN_CLI_OPTS -DskipTests=true -Dmaven.version.range.strict=true package -ntp

也可以临时指定具体版本绕过解析问题：

jf mvn $MAVEN_CLI_OPTS -DskipTests=true -Dspring-core.version=5.3.34 package -ntp

5. 改用原生Maven执行 #

若jf mvn的封装是问题根源，可在CI脚本中替换为原生Maven命令，确保环境与本地一致：

script:
  - mvn $MAVEN_CLI_OPTS -DskipTests=true package -ntp

需提前确保Runner已配置好仓库访问权限。

内容的提问来源于stack exchange，提问作者Mikhail T.