Maven离线使用共享本地仓库报错，如何阻止其尝试下载依赖？

问题原因 #

Maven的离线模式判断依赖是否可用，不只是检查本地仓库是否存在依赖文件，还会校验仓库元数据记录（比如.lastUpdated文件、maven-metadata.xml）。你在虚拟机中下载依赖时，这些元数据会生成在仓库对应目录下，但主机的Maven没有这些元数据记录，或者主机Maven的仓库配置中，该依赖对应的远程仓库标记为“从未下载过此依赖”，所以即使文件存在，离线模式下Maven仍会尝试去远程仓库验证，最终报错。

解决办法 #

• 确保共享仓库中包含该依赖的完整目录结构：从虚拟机的本地仓库中复制com/yyy/yyy的整个文件夹到共享仓库对应路径，不要只复制jar包，要包含pom文件、元数据文件等所有相关文件。
• 在主机上执行命令触发Maven识别本地依赖：

  mvn dependency:resolve -Dartifact=com.yyy:yyy:pom:yyy
  

  这个命令会让Maven扫描本地仓库，更新自身的依赖记录，无需联网。
• 若能临时联网，在主机上执行mvn dependency:go-offline，该命令会预加载所有依赖的元数据，为离线构建做准备；若无法联网，因为依赖文件已存在，执行此命令也会扫描本地仓库生成所需元数据。
• 检查主机的settings.xml配置，确认localRepository路径正确指向共享仓库，且仓库镜像、远程仓库配置和虚拟机保持一致。

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