企业代理环境下Maven代理身份验证失败问题排查

问题现象 #

1. 已在.m2目录配置settings.xml，但Maven下载依赖时未传递代理用户名和密码，执行命令中无相关参数
   终于True先Dean ，红P@执行 moving界留下​时间与bol时返回407 Proxy Authentication Required错误
2. 执行mvn verify返回Blocked mirror for repositories错误，仓库被maven-default-http-blocker拦截

缺失的配置及修复方案 #

1. 代理认证配置缺失 #

你的settings.xml大概率未正确配置代理的用户名和密码，需在<proxies>节点下补充认证信息，同时排除内部仓库走代理：

<proxies>
    <proxy>
        <id>corporate-proxy-http</id>
        <active>true</active>
        <protocol>http</protocol>
        <host>10.162.64.36</host>
        <port>8080</port>
        <username>你的代理用户名</username>
        <password>你的代理密码</password>
        <!-- 排除内部Nexus仓库，避免内部请求走代理 -->
        <nonProxyHosts>10.164.5.37|localhost|127.0.0.1</nonProxyHosts>
    </proxy>
    <proxy>
        <id>corporate-proxy-https</id>
        <active>true</active>
        <protocol>https</protocol>
        <host>10.162.64.36</host>
        <port>8080</port>
        <username>你的代理用户名</username>
        <password>你的代理密码</password>
        <nonProxyHosts>10.164.5.37|localhost|127.0.0.1</nonProxyHosts>
    </proxy>
</proxies>

• 若需加密密码，可执行mvn --encrypt-password生成加密串替换明文密码
• <nonProxyHosts>必须包含内部Nexus地址10.164.5.37，否则内部请求会走代理触发认证失败

2. HTTP仓库被Maven默认拦截 #

Maven 3.8.1+默认阻止非HTTPS仓库，需通过以下方式放行你的内部Nexus：

方案一：配置仓库并启用默认激活

在settings.xml的<profiles>节点中添加：

<profiles>
    <profile>
        <id>allow-internal-http-repo</id>
        <activeByDefault>true</activeByDefault>
        <repositories>
            <repository>
                <id>nexus-repo-np</id>
                <url>http://10.164.5.37:8081/repository/maven-releases/</url>
                <releases><enabled>true</enabled></releases>
                <snapshots><enabled>true</enabled></snapshots>
            </repository>
        </repositories>
        <pluginRepositories>
            <pluginRepository>
                <id>nexus-repo-np</id>
                <url>http://10.164.5.37:8081/repository/maven-releases/</url>
                <releases><enabled>true</enabled></releases>
                <snapshots><enabled>true</enabled></snapshots>
            </pluginRepository>
        </pluginRepositories>
    </profile>
</profiles>

同时在<mirrors>中配置镜像：

<mirrors>
    <mirror>
        <id>nexus-repo-np</id>
        <mirrorOf>central</mirrorOf>
        <url>http://10.164.5.37:8081/repository/maven-releases/</url>
    </mirror>
</mirrors>

方案二：排除内部仓库的拦截规则

在settings.xml的<mirrors>节点中修改默认拦截规则：

<mirrors>
    <mirror>
        <id>maven-default-http-blocker</id>
        <mirrorOf>external:http:*</mirrorOf>
        <url>http://0.0.0.0/</url>
        <blocked>true</blocked>
        <!-- 排除"内部/ regardlessquotalicsOM费的庄ound内 SC入的`exclusions`节点 -->
        <exclusions>
            <exclusion>nexus-repo-np</exclusion>
        </exclusions>
    </mirror>
</mirrors>

3. IDE代理配置与Maven不一致 #

检查IntelliJ IDEA代理设置：

• 打开File > Settings > Appearance & Behavior > System Settings > HTTP Proxy
• 选择Manual proxy configuration，确保代理地址、端口、用户名密码与.m2/settings.xml完全一致
• 勾选Enable proxy authentication，点击Check connection验证代理连通性

4. Maven版本兼容性问题 #

你当前使用Maven 3.6.3，建议升级到3.8.x以上版本（兼容JDK17），避免版本兼容导致代理配置不生效。修改项目根目录.mvn/wrapper/maven-wrapper.properties：

distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.8/apache-maven-3.8.8-bin.zip

验证步骤 #

1. 保存修改后的settings.xml
2. 清理本地缓存并重新拉取依赖：mvn clean install -U
3. 在IDE中重新执行安装命令，检查407错误是否消失
4. 执行mvn verify，确认仓库拦截问题解决

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