Apache Maven：降级至旧版SNAPSHOT依赖版本失败问题求助

这种情况我在日常开发中碰到过好几次，大概率是下面这几个原因导致的，你可以逐一排查：

• Maven本地仓库的元数据缓存未完全清除
  虽然你用了-U参数强制更新快照，但有时候Maven本地仓库里的maven-metadata.xml元数据文件可能还保留着旧的快照版本信息（比如旧的时间戳文件名）。Maven会优先根据这个元数据去拉取对应的快照包，而不是直接去Artifactory检查最新的。
  解决办法：手动删除本地仓库中该依赖的2.0.0-SNAPSHOT目录，比如路径类似~/.m2/repository/com/yourgroup/yourartifact/2.0.0-SNAPSHOT，删掉整个目录后再执行mvn clean install -U。

• Artifactory的快照存储策略导致元数据未更新
  Artifactory默认对SNAPSHOT版本有两种处理方式：一种是覆盖式存储（直接替换同一个SNAPSHOT包），另一种是时间戳版本存储（每个快照构建生成带时间戳的包，保留历史版本）。如果是时间戳存储模式，而Maven本地的元数据还指向旧的时间戳版本，即使你上传了新的2.0.0-SNAPSHOT，Maven还是会拉取旧的那个。
  解决办法：

  1. 登录Artifactory，找到该依赖的2.0.0-SNAPSHOT版本，确认新构建是否上传成功，且生成了新的时间戳包。
  2. 手动触发Artifactory重新生成该快照的元数据（部分版本需要手动刷新，或等待自动同步）。
  3. 也可以在Maven命令中添加-Dmaven.metadata.repository.enabled=true，强制从仓库拉取最新元数据。

• IDE的依赖缓存未同步
  如果你是在IDE（比如IntelliJ IDEA、Eclipse）中执行构建，IDE可能会自行缓存依赖包和元数据，即使Maven命令行已经拉到了最新内容，IDE里还是会使用旧版本。
  解决办法：

  • IntelliJ：点击File -> Invalidate Caches...，选择「Invalidate and Restart」，重启后重新构建。
  • Eclipse：右键项目 → Maven → Update Project，勾选Force Update of Snapshots/Releases，点击OK。

• Jenkins构建上传快照时的配置问题
  检查Jenkins任务上传Artifactory的配置，确认新的2.0.0-SNAPSHOT构建是否真的成功上传到了正确仓库，且覆盖了旧快照包（或生成了新的时间戳版本）。有时候Jenkins的Artifactory插件可能配置错误，导致上传失败但任务显示成功。
  解决办法：

  1. 查看Jenkins构建日志，确认快照上传步骤是否有报错，比如是否存在Deploying artifact to Artifactory的成功日志。
  2. 登录Artifactory，检查该依赖的2.0.0-SNAPSHOT目录下的文件，确认最新的jar/pom文件是否存在，且修改时间为最新。

• Maven settings.xml的快照仓库更新策略配置错误
  如果你的settings.xml里对快照仓库的updatePolicy设置不是always，即使使用-U参数，也可能因为配置优先级问题导致缓存未失效。比如updatePolicy设为daily时，Maven默认一天仅检查一次快照更新。
  解决办法：检查settings.xml中的仓库配置，确保快照仓库的updatePolicy为always：

  <repository>
    <id>your-snapshot-repo</id>
    <url>http://your-artifactory-url/snapshots</url>
    <snapshots>
      <enabled>true</enabled>
      <updatePolicy>always</updatePolicy>
    </snapshots>
  </repository>
  

  之后再执行mvn clean install -U重新构建。

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