一、問(wèn)題場(chǎng)景：升級(jí) Maven 后構(gòu)建失敗

如果你在使用 Maven 3.8.1 及以上版本 時(shí)，突然遇到以下錯(cuò)誤提示：

[ERROR] The HTTP repository protocol is not supported. Use HTTPS instead.

這通常意味著 Maven 默認(rèn) 禁止使用 HTTP 協(xié)議 的倉(cāng)庫(kù)（例如 http://repo.maven.apache.org/maven2），以提高安全性。此時(shí)，如果你的項(xiàng)目依賴(lài)的某些倉(cāng)庫(kù)必須通過(guò) HTTP 訪問(wèn)（例如公司內(nèi)網(wǎng)私有倉(cāng)庫(kù)或歷史遺留項(xiàng)目），構(gòu)建將直接失敗。

二、解決方案：通過(guò) <mirror> 配置覆蓋默認(rèn)行為

1. 配置示例

在 Maven 的 settings.xml 文件中添加以下配置：

<mirror>
    <id>maven-default-http-blocker</id>
    <mirrorOf>dummy</mirrorOf>
    <name>Dummy mirror to override default blocking mirror</name>
    <url>http://0.0.0.0/</url>
</mirror>

2. 配置解析

三、Maven 的 HTTP 阻斷機(jī)制背景

1. 背景知識(shí)

• Maven 3.8.1 版本引入：從該版本開(kāi)始，默認(rèn) 禁止使用 HTTP 協(xié)議 的倉(cāng)庫(kù)，強(qiáng)制要求使用 HTTPS。
• 目的：防止中間人攻擊（MITM），確保依賴(lài)下載過(guò)程的安全性。

2. 默認(rèn)行為

• 如果項(xiàng)目中配置了 HTTP 倉(cāng)庫(kù)（如 <url>http://...</url>），Maven 會(huì)拋出錯(cuò)誤并終止構(gòu)建。
• 如果未配置 HTTP 倉(cāng)庫(kù)，但依賴(lài)的遠(yuǎn)程倉(cāng)庫(kù)（如中央倉(cāng)庫(kù)）通過(guò) HTTP 訪問(wèn)，Maven 也會(huì)報(bào)錯(cuò)。

四、此配置的作用與原理

1. 核心作用

• 覆蓋默認(rèn)阻斷規(guī)則：通過(guò)配置一個(gè)無(wú)效的鏡像，Maven 會(huì)認(rèn)為已經(jīng)為 HTTP 倉(cāng)庫(kù)設(shè)置了鏡像，從而 跳過(guò)默認(rèn)的 HTTP 阻斷檢查。
• 解決構(gòu)建失敗：允許項(xiàng)目繼續(xù)使用 HTTP 倉(cāng)庫(kù)，避免因協(xié)議限制導(dǎo)致的構(gòu)建中斷。

2. 技術(shù)原理

• Maven 在初始化時(shí)會(huì)檢查所有倉(cāng)庫(kù)的 URL 協(xié)議。
• 如果發(fā)現(xiàn) HTTP 協(xié)議且未配置對(duì)應(yīng)的 HTTPS 鏡像，則觸發(fā)阻斷。
• 通過(guò)配置一個(gè) <mirrorOf>dummy</mirrorOf> 的鏡像（即使 URL 無(wú)效），Maven 會(huì)認(rèn)為 HTTP 倉(cāng)庫(kù)已被鏡像覆蓋，從而 不再執(zhí)行阻斷邏輯。

五、此配置的潛在問(wèn)題與風(fēng)險(xiǎn)

1. 無(wú)效的 URL 導(dǎo)致的問(wèn)題

http://0.0.0.0/ 是無(wú)效地址：此配置僅用于繞過(guò)阻斷，實(shí)際不會(huì)生效。如果項(xiàng)目依賴(lài)的倉(cāng)庫(kù)仍需通過(guò) HTTP 訪問(wèn)，構(gòu)建最終仍會(huì)失敗。

正確做法：將 <url> 替換為 有效的 HTTPS 倉(cāng)庫(kù)地址，例如：

<url>https://repo.maven.apache.org/maven2</url>

2. 安全性風(fēng)險(xiǎn)

• HTTP 協(xié)議不安全：數(shù)據(jù)傳輸未加密，容易被中間人攻擊。
• 建議：優(yōu)先使用 HTTPS 倉(cāng)庫(kù)，僅在 無(wú)法修改倉(cāng)庫(kù)協(xié)議 的情況下使用此配置。

六、正確的配置示例

1. 繞過(guò) HTTP 阻斷（推薦）

如果需要臨時(shí)繞過(guò) HTTP 阻斷（例如內(nèi)網(wǎng)倉(cāng)庫(kù)必須使用 HTTP），可以配置如下：

<mirror>
    <id>http-mirror</id>
    <mirrorOf>central</mirrorOf>  <!-- 假設(shè)你要覆蓋中央倉(cāng)庫(kù) -->
    <url>https://repo.maven.apache.org/maven2</url>  <!-- 使用 HTTPS 地址 -->
</mirror>

2. 強(qiáng)制禁用 HTTP 阻斷（不推薦）

如果確實(shí)需要禁用 HTTP 阻斷（例如項(xiàng)目依賴(lài) HTTP 倉(cāng)庫(kù)），可配置如下：

<mirror>
    <id>http-blocker-bypass</id>
    <mirrorOf>!</mirrorOf>  <!-- 匹配所有倉(cāng)庫(kù) -->
    <url>http://0.0.0.0/</url>
</mirror>

七、優(yōu)勢(shì)與適用場(chǎng)景

1. 優(yōu)勢(shì)

• 快速解決問(wèn)題：無(wú)需修改項(xiàng)目依賴(lài)配置，直接通過(guò) settings.xml 繞過(guò) HTTP 阻斷。
• 兼容舊項(xiàng)目：適用于依賴(lài) HTTP 倉(cāng)庫(kù)的舊項(xiàng)目，避免因 Maven 版本升級(jí)導(dǎo)致構(gòu)建失敗。
• 臨時(shí)過(guò)渡方案：為遷移到 HTTPS 倉(cāng)庫(kù)提供緩沖期。

2. 適用場(chǎng)景

• 公司內(nèi)網(wǎng)私有倉(cāng)庫(kù)僅支持 HTTP。
• 項(xiàng)目依賴(lài)的第三方倉(cāng)庫(kù)未提供 HTTPS。
• 緊急修復(fù)構(gòu)建問(wèn)題，后續(xù)計(jì)劃遷移到 HTTPS。

八、最佳實(shí)踐建議

1. 優(yōu)先使用 HTTPS 倉(cāng)庫(kù)

• 修改倉(cāng)庫(kù)地址：將所有 HTTP 倉(cāng)庫(kù)替換為 HTTPS。
• 升級(jí)私有倉(cāng)庫(kù)：確保內(nèi)部倉(cāng)庫(kù)支持 HTTPS 協(xié)議。

2. 明確配置

<mirrorOf> 避免使用 dummy 或 !，而是指定具體的倉(cāng)庫(kù) ID（如 central）。

示例：

<mirror>
    <id>central-mirror</id>
    <mirrorOf>central</mirrorOf>
    <url>https://repo.maven.apache.org/maven2</url>
</mirror>

3. 驗(yàn)證配置有效性

運(yùn)行測(cè)試命令：

mvn dependency:resolve -X

檢查日志中是否顯示使用了正確的鏡像地址。

到此這篇關(guān)于Maven 配置中的 ＜mirror＞繞過(guò) HTTP 阻斷機(jī)制的方法的文章就介紹到這了,更多相關(guān)Maven 配置＜mirror＞內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論