Maven无法下载自行编写的自定义构建扩展报错排查

• 核心配置错误：Maven对不同类型的构件使用独立的仓库配置规则：你在pom中配置的<repositories>节点仅对项目普通<dependencies>下的依赖生效；而构建扩展（build extensions）、Maven插件、插件依赖的解析，默认只会读取<pluginRepositories>节点下配置的仓库，默认仅包含Maven中央仓库，完全不会读取你自定义的simuline仓库，这也是报错中明确提示只去中央仓库查找、完全没访问你的私有仓库的原因。本地安装0.0.4-SNAPSHOT版本能正常运行，是因为本地仓库优先级最高，不需要走远程拉取流程，直接绕开了远程仓库配置缺失的问题。
• 首次解析失败的结果被Maven本地仓库缓存：Maven默认会将依赖解析失败的结果缓存24小时，期间不会重新尝试从远程拉取，直接返回缓存的失败结果，就算后续配置改对也可能受缓存影响报错。

1. 补充插件仓库配置
   在pom.xml（或全局Maven配置settings.xml）中新增<pluginRepositories>配置，将你的自定义仓库加入插件解析的仓库列表，配置示例如下：

   <pluginRepositories>
       <pluginRepository>
           <id>publicRepoAtSimuline</id>
           <name>repo at simuline</name>
           <url>https://www.simuline.eu/RepositoryMaven</url>
           <releases>
               <enabled>true</enabled>
           </releases>
           <snapshots>
               <enabled>true</enabled>
           </snapshots>
       </pluginRepository>
   </pluginRepositories>
   

2. 清理本地失败缓存
   执行以下命令清除qMngmnt构件的本地缓存，或者直接删除本地Maven仓库（默认路径为~/.m2/repository/）下eu/simuline/qMngmnt整个文件夹：

   mvn dependency:purge-local-repository -DmanualInclude="eu.simuline:qMngmnt"
   

3. 强制更新依赖构建
   执行构建命令时增加-U参数，强制Maven跳过更新间隔检查，重新拉取所有远程依赖：

   mvn clean package -U
   

补充说明：你提到同仓库下其他未作为扩展/插件依赖引用的构件可以正常访问，正好对应两套仓库配置的规则差异——那些作为普通项目依赖的构件走<repositories>配置，所以能正常找到，而作为构建扩展加载的qMngmnt走插件仓库配置，才会出现拉取失败的问题。

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