Maven无法识别本地仓库0.9.21版本依赖的原因排查

该问题和Maven解析本地依赖的机制、部署操作疏漏、本地缓存几个维度直接相关，按出现概率从高到低排序：

• 部署0.9.21版本时deploy:deploy-file参数缺失，导致版本目录文件不全
  Maven不会只根据根目录的maven-metadata.xml判定依赖可用，必须在对应版本的子目录（即C:/Development/local-maven-repo/my/group/artif-idbla/0.9.21/）下存在三类核心文件：
  • 命名匹配的jar包：artif-idbla-0.9.21.jar
  • 该版本对应的pom文件：artif-idbla-0.9.21.pom
  • 上述两个文件对应的md5/sha1校验文件
    多数人第二次部署升级版本时，执行deploy命令只带了jar包路径，漏加-DpomFile=外部项目本地pom.xml路径参数，会导致目录下缺少pom或校验文件，Maven直接判定依赖不存在。可以直接打开0.9.21的版本目录，和正常可用的0.9.2版本目录对比文件结构，存在缺项就是这个原因。
• 失败部署留下的缓存文件阻断了解析流程
  如果第一次部署0.9.21时操作失败过，Maven会在对应版本目录下生成.lastUpdated后缀的标记文件，记录该版本解析失败的状态。哪怕后续把文件补全了，只要这个标记文件没被删除，Maven默认会跳过该版本的重新解析，直接抛出找不到依赖的错误。
  处理方式是直接删除本地仓库下my/group/artif-idbla的整个文件夹，重新执行带全参数的deploy命令部署，再刷新依赖即可；也可以执行mvn dependency:purge-local-repository -DincludeArtifactIds=artif-idbla命令主动清理该依赖的本地缓存。
• IDEA读取的本地仓库路径和部署用的路径不一致
  你自定义的本地仓库路径是file:C:/Development/local-maven-repo，但如果IDEA的Maven配置里，Local repository项指向的是默认的${user.home}/.m2/repository路径，就会出现路径不匹配的问题：第一次部署0.9.2时可能刚好两个路径下都存了依赖副本，第二次部署只写入了你指定的自定义仓库，IDEA读取的默认仓库里只有0.9.2版本，自然找不到0.9.21。可以打开IDEA的Settings -> Build, Execution, Deployment -> Build Tools -> Maven页面，核对本地仓库配置路径是否正确。
• 校验文件不匹配导致依赖被判定为损坏
  如果手动拷贝过jar、pom文件到版本目录，和deploy阶段自动生成的sha1/md5校验值不一致，Maven会认为文件损坏拒绝加载，也会抛出无法解析依赖的报错，这种情况删除目录下所有校验文件，重新执行deploy命令生成正确校验值即可。

快速定位根因的方法：在主项目根目录执行带debug参数的构建命令mvn compile -X，在输出日志中搜索artif-idbla:0.9.21关键字，日志会明确打印依赖解析失败的具体原因，是路径不对、文件缺失还是校验失败，比IDEA控制台的简略报错信息定位效率高很多。

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