Resolving Maven Archetype Generation Issues

In Java development, the Maven archetype plugin can hang or fail when generating a project.

Typical symptom: long wait with log line [INFO] Generating project in Batch mode and possible errors.

Solution 1: Add the parameter archetypeCatalog=internal when creating the Maven project.

Solution 2: Add VM option -DarchetypeCatalog=internal or -DarchetypeCatalog=local in Maven settings (Settings → Build, Execution, Deployment → Build Tools → Maven → Runner → VM Options).

Solution 3: Download or create an archetype-catalog.xml (e.g., via curl http://repo1.maven.org/maven2/archetype-catalog.xml > archetype-catalog.xml ) and place it in the Maven repository directory ~/.m2 or configure its path in /config/settings.xml . Then run archetype:generate -DarchetypeCatalog=local .

Solution 4: Edit Maven's conf/settings.xml to use a domestic mirror, for example:

<mirror>
    <id>alimaven</id>
    <name>aliyun maven</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
    <mirrorOf>central</mirrorOf>
</mirror>

After applying these changes, project generation completes quickly (e.g., 1.146 s).