Maven自定义Archetype生成后Groovy脚本依赖无法解析问题

核心问题原因 #

你的Archetype项目中添加的kafka-clients依赖仅用于Archetype自身的编译和IDE开发环境，但执行mvn archetype:generate时，Groovy生成后脚本是运行在maven-archetype-plugin的类加载器中，而非Archetype项目的类加载器。因此，插件本身无法访问Archetype项目的依赖，导致Kafka相关类无法被解析。

解决方案：为maven-archetype-plugin添加依赖 #

需要直接在maven-archetype-plugin的配置中声明kafka-clients依赖，让插件加载时能获取到这些类。修改Archetype项目的pom.xml，在pluginManagement下的maven-archetype-plugin节点中添加<dependencies>块：

<pluginManagement>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-archetype-plugin</artifactId>
      <version>3.2.1</version>
      <!-- 添加插件级依赖 -->
      <dependencies>
        <dependency>
          <groupId>org.apache.kafka</groupId>
          <artifactId>kafka-clients</artifactId>
          <version>3.4.0</version>
        </dependency>
        <!-- 若出现SLF4J相关报错，可添加SLF4J依赖（kafka-clients依赖它） -->
        <!--
        <dependency>
          <groupId>org.slf4j</groupId>
          <artifactId>slf4j-api</artifactId>
          <version>1.7.36</version>
        </dependency>
        -->
      </dependencies>
    </plugin>
  </plugins>
</pluginManagement>

后续步骤 #

1. 重新执行mvn clean install，将更新后的Archetype安装到本地仓库
2. 再次运行mvn archetype:generate创建新项目，此时脚本应能正常解析Kafka类

补充说明 #

• IDE中直接运行脚本正常是因为IDE使用了Archetype项目的完整类路径（包含kafka-clients依赖），而Maven插件运行时的类路径是独立隔离的。
• 若脚本还依赖其他类，需将对应的依赖同样添加到maven-archetype-plugin的<dependencies>中。

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