Maven私有仓库配置后请求未携带Authorization Header问题咨询

可能的原因 #

• HTTP地址授权限制：Maven 3.x 默认禁止对非HTTPS的仓库地址发送Authorization头，避免明文凭证泄露，你当前使用的http://127.0.0.1地址属于HTTP协议，触发了该限制。
• ID匹配错误：settings.xml中server节点的id必须和pom.xml中repository节点的id完全大小写一致，才能匹配到对应的授权信息，你当前配置是匹配的，后续修改配置时需注意该规则。
• settings.xml未生效：Maven会优先加载用户目录下的~/.m2/settings.xml，其次加载Maven安装目录下的conf/settings.xml，如果修改的是其他位置的配置文件，不会生效。
• 配置覆盖冲突：父POM、settings.xml的profile节点中如果存在同id的仓库配置，会覆盖当前项目的配置，导致授权信息匹配失败。
• Wagon组件缺陷：Maven 3.6.3内置的wagon-http组件存在已知bug，会偶发出现授权头丢失的问题。
• 高版本Maven拦截HTTP仓库：如果后续升级到Maven 3.8.1+，默认会拦截所有HTTP仓库的请求，也会导致授权头无法正常发送。

排查与解决方法 #

1. 确认配置生效状态
   执行mvn help:effective-settings命令，查看实际生效的配置，确认输出中存在id为kingtux-dev、用户名密码正确的server节点。如果不存在，检查你修改的settings.xml路径是否正确。
   执行mvn help:effective-pom命令，查看最终生效的POM配置，确认repositories节点下的kingtux-dev仓库配置没有被覆盖。

2. 处理HTTP协议限制
   两种方案二选一：

   • （推荐）给私有仓库配置HTTPS证书，将pom.xml中的仓库地址改为HTTPS开头，Maven会自动携带授权头。
   • 本地调试场景坚持使用HTTP的话，执行Maven命令时添加参数允许HTTP传输授权信息：

     mvn <你的实际命令> -Dmaven.wagon.http.allowInsecureAuthOverHttp=true
     

     也可以将该参数配置到settings.xml的properties节点全局生效：

     <properties>
         <maven.wagon.http.allowInsecureAuthOverHttp>true</maven.wagon.http.allowInsecureAuthOverHttp>
     </properties>
     

3. 适配高版本Maven的HTTP拦截规则
   如果你使用Maven 3.8.1+版本，需要在repository配置中添加blocked=false关闭拦截：

   <repository>
       <id>kingtux-dev</id>
       <name>My Developer Repo</name>
       <url>http://127.0.0.1:6742/storages/public/maven</url>
       <blocked>false</blocked>
   </repository>
   

4. 修复组件缺陷
   以上步骤都无效的情况下，升级Maven到3.8.8+版本，或者单独升级wagon-http组件到3.5.0+版本即可修复已知的授权头丢失bug。

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