idea中使用maven archetype新建项目时卡住问题解决方案

背景

作为一个后端Java打工人，idea就是最重要的打饭工具。创建项目，熟悉吧，但是，这么多年下来，因为idea换了版本，电脑换了等等，我还是时不时遇到根据maven archetype新建maven项目卡住。没错，我说的就是下面这样的场景：

总之吧，就是停在上面这里，不动了：

[INFO] --- maven-archetype-plugin:3.2.1:generate (default-cli) @ standalone-pom ---

[INFO] Generating project in Batch mode

以前都是网上随便找个文章搞一搞，或者有时候多等一会，解决了也就不管了，直到下次因为换电脑、重装idea等等，又不行了。我也奇怪，你拿 Generating project in Batch mode 去网上一搜，出来的解决办法还各不相同。

这次我决定好好探究下，了解下内部原理，知其然，也要知其所以然，把这个小问题搞清楚。

打开debug级别参数，查看阻塞原因

首先，点这里，可以看到完整命令：

基本就是：

"C:\Program Files\Java\jdk1.8.0_202\bin\java.exe" 
-Dmaven.home=F:\tools\apache-maven-3.8.1-bin\apache-maven-3.8.1  
--errors
-DgroupId=org.example
-DartifactId=test8
-Dversion=1.0-SNAPSHOT

-DarchetypeGroupId=org.apache.maven.archetypes
-DarchetypeArtifactId=maven-archetype-quickstart
-DarchetypeVersion=1.4

-DarchetypeRepository=F:/maven/repository

org.apache.maven.plugins:maven-archetype-plugin:RELEASE:generate

可以看下上面的命令，我已经去除了不重要的参数，剩下的分几个部分：

• maven home目录
• 日志级别，目前是-errors，不会打印太详细的日志
• -DgroupId/-DartifactId/-Dversion 我们要生成的业务module的坐标
• -DarchetypeGroupId/-DarchetypeArtifactId/-DarchetypeVersion module模版/原型的坐标
• -DarchetypeRepository module模版/原型的本地仓库位置
• org.apache.maven.plugins:maven-archetype-plugin:RELEASE:generate 丢给maven的执行参数，表示要执行的插件及目标

上面这里，日志级别是比较高的，我们需要调低，怎么调呢，通过idea的settings即可：

打开debug级别后，再次运行，命令里就会多出一个： --debug 参数，而运行时就会出现如下日志：

![image-20230818221704629](https://dump-1252523945.cos.ap-

shanghai.myqcloud.com/img/202308182217713.png)

日志显示正在获取某个xml文件。

这个文件的url已经给出来了，网上都是说，文件特别大，可以自己浏览器下载下来，放到某个位置，然后再改个参数 -DarchetypeCatalog=local ，后续让maven都从这个位置去读即可。

我看了下，这个文件确实大，14M左右，而且是从maven官方仓库那小水管下载，确实要卡很久，文件是干啥的呢，catalog表示目录，合起来意思就是项目模版的目录，比如我们常用的quickstart，只是其中的一个：

-DarchetypeGroupId=org.apache.maven.archetypes
-DarchetypeArtifactId=maven-archetype-quickstart
-DarchetypeVersion=1.4

文件内容大概如下，整个文件包含了5w多个模板，这么多，能不慢吗：

一个疑问

按照网上的方案，我把文件下载下来了，但我还不知道把文件放到哪里去。

我想着，我先把参数 -DarchetypeCatalog=local 改了，看看debug日志，在local参数情况下，是去哪里获取这个文件：

然后，注意啊，敲黑板了！rerun的话，这个参数是不生效的，必须新建project或module，这个参数才会生效，也就是说，之前建的都没效果，仅对新project、module生效。

此时，如下，它会去本地仓库的根目录下查找这个目录文件：

ok，知道去哪里放这个目录文件了，问题是，我还没放呢，但它这次执行为啥就成功了呢？

虽然成功了，但是给我整得有点迷茫，不知道怎么就成功了。我以为是idea有什么缓存，我还重启了几次idea，后来发现应该就是这样设计的：

加了-DarchetypeCatalog=local的情况下，会在本地的本地仓库下找 archetype-catalog.xml 。但我们没放，所以找不到。找不到的话，它也就放弃了，会直接去maven中央仓库拉取这个指定模版的jar下来。

[DEBUG] Getting archetypes from catalog: F:\maven\repository\archetype-catalog.xml
// 下面这行，意思是容错处理，去中央仓库拉取
[WARNING] Archetype not found in any catalog. Falling back to central repository.

拉取下来的模版/原型的内容

我们前面提到，模版的坐标为：

-DarchetypeGroupId=org.apache.maven.archetypes
-DarchetypeArtifactId=maven-archetype-quickstart
-DarchetypeVersion=1.4

拉取下来后，我们看看其内容：

jar包解压后，发现很眼熟，就是我们模板项目的内容：

打开其中两个文件查看，发现还有不少占位符：

下面这个App.java的$package占位符，我们在命令里没有显式传递，是maven获取了 -DgroupId=com.example 的值作为其默认值。

所以，解决本问题的方法，就是在maven的runner加上参数-DarchetypeCatalog=local就可以了，不需要下载xml文件再放到指定目录。

如果我们放置的话呢，看看日志是啥样：

[INFO] Generating project in Batch mode
[DEBUG] Getting archetypes from catalog: F:\maven\repository\archetype-catalog.xml
[INFO] Archetype repository not defined. Using the one from [org.apache.maven.archetypes:maven-archetype-quickstart:1.4] found in catalog local

了解该插件

https://maven.apache.org/archetype/maven-archetype-plugin/

我也是才知道，还可以根据现在已有的项目来生成模版，感觉还是不错的，后面打算研究下，毕竟公司内项目一多，在项目间需要复用的东西就越来越多，搞个模版工程还是不错的。

该插件的goal：generate

我们上面使用的就是该插件的generate 目标：

https://maven.apache.org/archetype/maven-archetype-plugin/generate-mojo.html

这里就有各个参数的解释，这也是为什么网上文章都让我们这么改参数的原因：

mvn命令如何执行该插件

mvn archetype:generate  
 -DarchetypeGroupId=org.apache.maven.archetypes
 -DarchetypeArtifactId=maven-archetype-quickstart
 -DarchetypeVersion=1.1 
 -DgroupId=com.company
 -DartifactId=project
 -Dversion=1.0-SNAPSHOT
 -Dpackage=com.company.project
 -X --errors -DarchetypeCatalog=local

这里-X，就和表示前面idea中的debug级别日志是一样的，具体可查看 mvn -h :

 -X,--debug                             Produce execution debug output

另外，注意这里，指定了-Dpackage，即手动指定了我们module的包名。

到此这篇关于idea中使用maven archetype新建项目时卡住的文章就介绍到这了,更多相关idea新建项目时卡住内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论