一、背景

在 Java Maven 項(xiàng)目中，我們經(jīng)常會(huì)看到不同形式的版本號(hào)，例如：

<version>1.0.0-SNAPSHOT</version>
<version>1.0.0</version>
<version>1.0.0-RELEASE</version>

這些版本號(hào)看起來(lái)差別不大，但在 Maven 構(gòu)建、依賴(lài)管理和生產(chǎn)環(huán)境穩(wěn)定性方面，影響非常明顯。

本文將系統(tǒng)說(shuō)明 Maven 中的快照版本、正式版本，以及 Nexus 倉(cāng)庫(kù)中的常見(jiàn)規(guī)則和最佳實(shí)踐。

二、Maven 中的版本類(lèi)型

1. SNAPSHOT 快照版本

以 -SNAPSHOT 結(jié)尾的版本，稱(chēng)為快照版本。

示例：

<version>1.0.0-SNAPSHOT</version>

SNAPSHOT 表示該版本仍處于開(kāi)發(fā)階段，內(nèi)容可能隨時(shí)變化。

當(dāng)快照版本發(fā)布到 Nexus 后，Maven 實(shí)際上傳的文件名可能會(huì)變成：

demo-1.0.0-20260513.102233-3.jar

但項(xiàng)目中依賴(lài)時(shí)仍然寫(xiě)：

<version>1.0.0-SNAPSHOT</version>

Maven 會(huì)通過(guò) maven-metadata.xml 找到最新的快照構(gòu)建。

2. Release 正式版本

不以 -SNAPSHOT 結(jié)尾的版本，默認(rèn)都是正式版本。

示例：

<version>1.0.0</version>

正式版本表示該版本已經(jīng)發(fā)布完成，內(nèi)容應(yīng)當(dāng)穩(wěn)定且不可變。

如果發(fā)現(xiàn)問(wèn)題，不應(yīng)該覆蓋原來(lái)的 1.0.0，而應(yīng)該發(fā)布新的版本，例如：

1.0.0 -> 1.0.1 -> 1.0.2

3. 只有版本號(hào)是什么意思

例如：

<version>1.0.0</version>

這是 Maven 中最標(biāo)準(zhǔn)的正式版本寫(xiě)法。

而：

<version>1.0.0-RELEASE</version>

雖然也會(huì)被 Maven 當(dāng)作正式版本，但通常沒(méi)有必要。因?yàn)?Maven 本身已經(jīng)通過(guò)是否包含 -SNAPSHOT 來(lái)區(qū)分快照版本和正式版本。

三、Nexus 中的倉(cāng)庫(kù)類(lèi)型

Nexus通常會(huì)配置兩個(gè) Maven 倉(cāng)庫(kù)：

常見(jiàn)對(duì)應(yīng)關(guān)系如下：

1.0.0-SNAPSHOT -> maven-snapshots
1.0.0          -> maven-releases
1.0.0-RELEASE  -> maven-releases

如果將 SNAPSHOT 版本發(fā)布到 release 倉(cāng)庫(kù)，或者將正式版本發(fā)布到 snapshot 倉(cāng)庫(kù)，Nexus 通常會(huì)拒絕上傳。

四、不同版本類(lèi)型的影響

1. 對(duì)構(gòu)建穩(wěn)定性的影響

SNAPSHOT 版本是可變的，同一個(gè)版本號(hào)可能對(duì)應(yīng)不同的包內(nèi)容。

這意味著：

<version>1.0.0-SNAPSHOT</version>

今天構(gòu)建成功，明天可能因?yàn)橐蕾?lài)包被重新發(fā)布而失敗。

正式版本則不同：

<version>1.0.0</version>

只要 Nexus 不允許覆蓋，任何時(shí)間拉取到的 1.0.0 都應(yīng)該是同一個(gè)內(nèi)容。

2. 對(duì)問(wèn)題排查的影響

如果生產(chǎn)環(huán)境依賴(lài)了 SNAPSHOT，出現(xiàn)問(wèn)題時(shí)很難確認(rèn)當(dāng)時(shí)實(shí)際使用的是哪一次構(gòu)建產(chǎn)物。

正式版本更容易追蹤問(wèn)題：

服務(wù)版本：1.0.1
依賴(lài)版本：common-utils-2.3.0
發(fā)布時(shí)間：2026-05-13

版本清晰后，日志、部署記錄、制品倉(cāng)庫(kù)和代碼提交記錄才能對(duì)應(yīng)起來(lái)。

3. 對(duì)團(tuán)隊(duì)協(xié)作的影響

開(kāi)發(fā)階段使用 SNAPSHOT 可以提升聯(lián)調(diào)效率。

例如公共模塊還在頻繁修改時(shí)，業(yè)務(wù)項(xiàng)目可以先依賴(lài)：

<version>2.0.0-SNAPSHOT</version>

但進(jìn)入測(cè)試驗(yàn)收或生產(chǎn)發(fā)布階段，應(yīng)當(dāng)切換為明確的正式版本：

<version>2.0.0</version>

五、常見(jiàn)問(wèn)題

1. 生產(chǎn)環(huán)境依賴(lài) SNAPSHOT

這是非常不推薦的做法。

原因包括：

• 構(gòu)建不可復(fù)現(xiàn)
• 包內(nèi)容可能被覆蓋
• 問(wèn)題排查困難
• 發(fā)布鏈路不可審計(jì)

生產(chǎn)環(huán)境應(yīng)當(dāng)依賴(lài)明確的 release 版本。

2. 重復(fù)發(fā)布同一個(gè) release 版本

如果 Nexus 允許覆蓋 release 包，會(huì)帶來(lái)嚴(yán)重風(fēng)險(xiǎn)。

例如第一次發(fā)布的 1.0.0 和第二次覆蓋上傳的 1.0.0 內(nèi)容不同，但版本號(hào)完全一樣。

這會(huì)導(dǎo)致不同環(huán)境、不同機(jī)器、不同時(shí)刻拉到的依賴(lài)內(nèi)容不一致。

正確做法是：發(fā)現(xiàn)問(wèn)題 -> 修改代碼 -> 升級(jí)版本號(hào) -> 發(fā)布新版本

例如：1.0.0 -> 1.0.1

3. 使用 LATEST 或 RELEASE 作為依賴(lài)版本

不建議這樣寫(xiě)：

<version>LATEST</version>
<version>RELEASE</version>

這種寫(xiě)法會(huì)讓 Maven 自動(dòng)選擇版本，構(gòu)建結(jié)果不可控?，F(xiàn)代 Maven 項(xiàng)目中應(yīng)當(dāng)顯式指定具體版本號(hào)。

六、推薦實(shí)踐

1. 開(kāi)發(fā)階段使用 SNAPSHOT

<version>1.1.0-SNAPSHOT</version>

適用于：

• 本地開(kāi)發(fā)
• 模塊聯(lián)調(diào)
• 測(cè)試環(huán)境快速驗(yàn)證

2. 發(fā)布階段使用正式版本

<version>1.1.0</version>

適用于：

• 測(cè)試驗(yàn)收
• 預(yù)發(fā)環(huán)境
• 生產(chǎn)環(huán)境
• 對(duì)外發(fā)布的公共組件

3. Release 倉(cāng)庫(kù)禁止覆蓋

Nexus 中建議配置 release 倉(cāng)庫(kù)不允許重復(fù)部署。

這樣可以保證：

• 版本不可變
• 構(gòu)建可復(fù)現(xiàn)
• 問(wèn)題可追蹤
• 發(fā)布鏈路更可靠

4. 版本號(hào)保持簡(jiǎn)潔

推薦：

1.0.0
1.0.1
1.1.0
2.0.0

不推薦無(wú)必要地寫(xiě)成：

1.0.0-RELEASE

因?yàn)?1.0.0 本身已經(jīng)是正式版本。

七、總結(jié)

Maven 中判斷快照版本和正式版本的核心規(guī)則非常簡(jiǎn)單：

只有以 -SNAPSHOT 結(jié)尾的版本才是快照版本，其他版本默認(rèn)都是正式版本。

SNAPSHOT 適合開(kāi)發(fā)和聯(lián)調(diào)，特點(diǎn)是靈活但不穩(wěn)定。

Release 適合正式發(fā)布，特點(diǎn)是穩(wěn)定、可追蹤、可復(fù)現(xiàn)。

最終推薦規(guī)范如下：

• 開(kāi)發(fā)版本：1.0.1-SNAPSHOT
• 正式版本：1.0.1
• 修復(fù)版本：1.0.2

良好的版本管理不僅能減少依賴(lài)沖突，也能提升構(gòu)建穩(wěn)定性、發(fā)布可靠性和線上問(wèn)題排查效率。

到此這篇關(guān)于Maven版本管理之SNAPSHOT,Release與Nexus倉(cāng)庫(kù)的區(qū)別和影響詳解的文章就介紹到這了,更多相關(guān)Maven版本管理內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論