Maven公司私库配置踩坑点

QC班长2026-04-24 23:53

最近在使用Maven拉取公司私库的依赖包时，出现了，拉不下来的问题，一直报错，在 Maven settings.xml 中配置也加了私库地址，认证的账号密码也加了，

XML 复制代码

<settings>
  <servers>
    <server>
      <id>qc-maven-release</id>
      <username>你的用户名</username>
      <password>你的密码</password>
    </server>
  </servers>
</settings>

后面真正的问题是：Maven Mirror 拦截

从错误信息看：

Blocked mirror for repositories: [qc-maven-release (...

http://10.1.1.23:8081...)]

Maven 正在拦截你的私库请求。这通常是因为在 settings.xml 中配置了 <mirrorOf> 包含了这个仓库。

请检查你的 ~/.m2/settings.xml ，看看是否有类似这样的配置：

XML 复制代码

<mirrors>
  <mirror>
    <id>aliyun</id>
    <mirrorOf>*</mirrorOf>  <!-- 这个 * 会拦截所有仓库 -->
    ...
  </mirror>
</mirrors>

❌ 错误配置（会拦截私库）

XML 复制代码

<mirror>
  <id>aliyun</id>
  <mirrorOf>*</mirrorOf>   <!-- * 表示所有仓库都走这个镜像 -->
</mirror>

✅ 正确配置（排除私库）

XML 复制代码

<mirror>
  <id>aliyun</id>
  <mirrorOf>*,!yqc-maven-release,!yqc-maven-snapshot</mirrorOf>  
  <!-- ! 表示排除，!qc-maven-release 表示私库不走这个镜像 -->
</mirror>

📋 完整正确的 settings.xml 示例

XML 复制代码

<settings>
  <!-- 私库认证信息 -->
  <servers>
    <server>
      <id>qc-maven-release</id>
      <username>你的用户名</username>
      <password>你的密码</password>
    </server>
    <server>
      <id>qc-maven-snapshot</id>
      <username>你的用户名</username>
      <password>你的密码</password>
    </server>
  </servers>

  <!-- 镜像配置（排除私库） -->
  <mirrors>
    <mirror>
      <id>aliyun</id>
      <name>Aliyun Maven</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>*,!qc-maven-release,!qc-maven-snapshot</mirrorOf>
    </mirror>
  </mirrors>
</settings>

这种配置完就正常了，原因还是不太熟练Maven的仓库配置，不知道<mirrorOf>*</mirrorOf>中的*会拦截所有表单，所以拉不下来，其实还是AI快速分析出的结果。