自定义Maven Archetype生成项目失败，请求技术排查

核心错误点及修复方案 #

1. Archetype项目打包类型错误 #

你的archetype pom.xml中<packaging>设置为jar，但Maven archetype项目必须使用maven-archetype作为打包类型，否则插件无法正确识别和处理该项目为archetype。

修复后的pom.xml打包配置：

<packaging>maven-archetype</packaging>

2. Archetype描述符文件位置错误 #

archetype.xml必须放在src/main/resources/META-INF/maven/目录下，否则maven-archetype-plugin无法找到该描述符文件，这会直接导致生成项目时出现空指针异常。

调整后的目录结构：

maven-archetype-tarkshala-service-models/
├── src/
│   └── main/
│       └── resources/
│           ├── META-INF/
│           │   └── maven/
│           │       └── archetype.xml
│           └── archetype-resources/  <!-- 存放要生成的项目模板文件，如src、pom.xml等 -->
└── pom.xml

3. 编译器配置冲突与插件版本缺失 #

• pom.xml中build块里的maven-compiler-plugin指定了Java 18，但<properties>里又设置了Java 17，版本冲突。
• maven-compiler-plugin缺少<version>配置，违反Maven规范，会导致构建警告。

修复后的编译器配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version> <!-- 添加稳定版本 -->
            <configuration>
                <source>18</source>
                <target>18</target>
                <compilerArgs>--enable-preview</compilerArgs>
            </configuration>
        </plugin>
        <!-- 必须添加maven-archetype-plugin，确保archetype正确构建 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-archetype-plugin</artifactId>
            <version>3.2.1</version>
            <extensions>true</extensions>
        </plugin>
    </plugins>
</build>

<!-- 删除冲突的properties，保持版本一致 -->
<properties>
    <maven.compiler.source>18</maven.compiler.source>
    <maven.compiler.target>18</maven.compiler.target>
</properties>

4. 执行generate命令的上下文错误 #

你在archetype项目内部执行mvn archetype:generate，这会导致插件尝试在当前项目基础上生成，引发上下文冲突。正确的做法是：

1. 先在archetype项目根目录执行mvn clean install，将archetype安装到本地仓库。
2. 退出当前archetype项目目录，创建一个空目录，在该目录下执行generate命令。

修正后的generate命令执行步骤：

# 1. 安装archetype到本地仓库
cd maven-archetype-tarkshala-service-models
mvn clean install

# 2. 切换到空目录执行生成命令
cd ../new-project-dir
mvn archetype:generate \
    -DarchetypeGroupId=com.tarkshala \
    -DarchetypeArtifactId=maven-archetype-tarkshala-service-models \
    -DarchetypeVersion=1.0-SNAPSHOT \
    -DgroupId=com.tarkshala \
    -DartifactId=dhaba-models \
    -DprojectName=DhabaModels

额外注意事项 #

• archetype-resources目录是存放模板文件的核心目录，所有需要生成的项目文件（如src结构、pom.xml、yml等）都要放在这里，且文件中的占位符（如${projectName}）会被插件替换。
• 确保archetype.xml中的<name>与项目实际名称一致，避免混淆。

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