如何让Maven archetype:generate使用最新SNAPSHOT版本？

问题说明 #

当使用LATEST作为archetypeVersion参数时，Maven总是解析到最新正式发布版（如0.0.8）；但手动指定具体SNAPSHOT版本号（如0.0.9-SNAPSHOT），配合现有settings配置可以正常生成基于最新快照版的项目。需要调整配置，让LATEST自动指向仓库中的最新SNAPSHOT版本。

原因分析 #

1. Maven的LATEST版本标识符默认优先匹配正式发布版（Releases），即使快照仓库已开启，也不会主动将快照版本纳入LATEST的候选范围。
2. 当前配置中，快照仓库的Profile未激活，Maven实际并未访问快照仓库获取元数据。
3. 使用archetypeCatalog=local参数时，插件仅读取本地缓存的archetype目录，无法获取远程仓库中的最新快照版本信息。

解决方案 #

1. 激活快照仓库Profile #

修改development-maven-settings.xml，添加<activeProfiles>标签激活快照仓库配置，确保Maven能访问快照仓库：

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 
          https://maven.apache.org/xsd/settings-1.0.0.xsd">

  <profiles>
    <profile>
      <id>sonatype-snapshots</id>
      <repositories>
        <repository>
          <id>archetype</id>
          <url>https://s01.oss.sonatype.org/content/repositories/snapshots</url>
          <releases>
            <enabled>false</enabled>
          </releases>
          <snapshots>
            <enabled>true</enabled>
            <checksumPolicy>warn</checksumPolicy>
          </snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>

  <!-- 激活快照仓库Profile -->
  <activeProfiles>
    <activeProfile>sonatype-snapshots</activeProfile>
  </activeProfiles>
</settings>

2. 调整Archetype Catalog参数 #

将命令中的-DarchetypeCatalog=local改为remote或local,remote，让插件从远程仓库拉取最新的archetype元数据：

mvn archetype:generate ^
  --show-version ^
  --settings development-maven-settings.xml ^
  -Dmaven.wagon.http.ssl.insecure=true ^
  -DarchetypeCatalog=remote ^
  -DarchetypeGroupId=dev.aherscu.qa ^
  -DarchetypeArtifactId=qa-testing-archetype ^
  -DarchetypeVersion=LATEST ^
  -DgroupId=com.acme ^
  -DartifactId=testing ^
  -Dversion=0.0.1-SNAPSHOT ^
  -Dpackage=com.acme.testing

3. 强制更新快照（可选） #

如果本地缓存了旧的快照版本，可以添加-U参数强制Maven更新快照元数据：

mvn archetype:generate ^
  --show-version ^
  --settings development-maven-settings.xml ^
  -U ^
  -Dmaven.wagon.http.ssl.insecure=true ^
  -DarchetypeCatalog=remote ^
  -DarchetypeGroupId=dev.aherscu.qa ^
  -DarchetypeArtifactId=qa-testing-archetype ^
  -DarchetypeVersion=LATEST ^
  -DgroupId=com.acme ^
  -DartifactId=testing ^
  -Dversion=0.0.1-SNAPSHOT ^
  -Dpackage=com.acme.testing

4. 清理本地缓存（可选） #

若上述操作仍未生效，可以手动清理本地仓库中该archetype的缓存目录：

# Linux/macOS
rm -rf ~/.m2/repository/dev/aherscu/qa/qa-testing-archetype/

# Windows
rd /s /q %USERPROFILE%\.m2\repository\dev\aherscu\qa\qa-testing-archetype\

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