添加镜像后仍报maven「Blocked mirror for repositories」错误如何解决

• 配置优先级冲突：Maven的配置存在全局、用户、项目三个层级，即使你复制了之前项目的配置，也可能存在全局settings.xml或者用户目录下的settings.xml规则覆盖了项目配置的情况，或者当前项目启用了独有的配置文件路径，导致镜像规则没有生效
• 镜像匹配规则未覆盖全部仓库：你配置的镜像<mirrorOf>字段可能只指定了特定的仓库ID，如果当前项目的pom.xml或父pom中配置了其他ID的远程仓库，镜像规则没有命中的情况下仍然会走原始的HTTP仓库拉取，触发报错
• 本地依赖缓存损坏：之前拉取失败的依赖会在本地仓库生成.lastUpdated后缀的标记文件，Maven默认会跳过这类残包的重新下载，即使配置了镜像也不会重新拉取
• Maven版本差异：两个项目使用的Maven版本不同，Maven 3.8.1及以上版本默认阻断所有HTTP仓库的请求，如果你用的镜像地址也是HTTP，旧版本配置没有添加<blocked>false的放行规则，新版本就会直接拦截请求
• 父pom或依赖传递引入未镜像的仓库：当前项目的依赖可能传递引入了其他HTTP仓库配置，优先级高于你配置的镜像，导致直接走原始地址拉取

• 执行mvn help:effective-settings命令，查看当前项目实际生效的配置，确认镜像规则是否正确加载，没有被上层配置覆盖
• 执行mvn clean install -U命令，强制更新快照依赖，跳过本地缓存的过期校验
• 找到本地Maven仓库的对应报错依赖目录，删除目录下所有.lastUpdated后缀的文件，或者直接删除整个依赖目录后重新构建
• 如果使用的是Maven 3.8.1及以上版本，在镜像配置中添加<blocked>false</blocked>字段放行HTTP镜像请求，示例配置如下：

<mirror>
  <id>custom-mirror</id>
  <mirrorOf>*</mirrorOf>
  <url>http://你的镜像地址</url>
  <blocked>false</blocked>
</mirror>

• 检查当前项目pom.xml、父pom的<repositories>和<pluginRepositories>节点，删除额外的HTTP仓库配置，或者调整镜像的<mirrorOf>规则匹配这些仓库的ID

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