新建Jakarta EE项目，Maven Archetype 选项无法加载出内容该怎么办？

新建Jakarta EE项目，Maven Archetype 选项无法加载出内容该怎么办？

这才是问题的核心，通常由以下几个原因导致，你可以按顺序排查：

1. 网络问题（最常见的原因）

       IntelliJ IDEA 需要连接到 Maven 中央仓库（Maven Central）来下载一个名为 archetype-catalog.xml 的索引文件。如果网络连接有问题，这个列表就无法加载。

解决方案：

• 检查代理设置：如果你在公司或学校网络环境下，很可能需要配置 HTTP 代理。
  • 进入 File -> Settings -> Appearance & Behavior -> System Settings -> HTTP Proxy。
  • 检查是否需要配置代理。如果不确定，可以询问你的网络管理员。
• 检查防火墙：确保你的防火墙或安全软件没有阻止 IntelliJ IDEA 的网络访问。
• 测试网络连接：尝试在浏览器中直接访问 Maven 仓库地址 https://repo.maven.apache.org/maven2/，看看是否能正常打开。

2. Maven 设置或索引问题

IntelliJ IDEA 使用的 Maven 索引可能已损坏或过时。

解决方案：

• 强制更新 Maven 仓库索引：

  • 打开 Maven 工具窗口 (View -> Tool Windows -> Maven)。
  • 点击左上角的刷新按钮 ("Reload All Maven Projects")。
  • 打开 Settings -> Build, Execution, Deployment -> Build Tools -> Maven -> Repositories。
  • 选中列表中的中央仓库 (https://repo.maven.apache.org/maven2/)，然后点击右侧的 Update 按钮。这个过程可能需要几分钟。

• 清理 IntelliJ IDEA 缓存：IDE 的缓存损坏也可能导致各种奇怪的问题。

  • 进入 File -> Invalidate Caches...。
  • 在弹出的对话框中，勾选 Clear file system cache and Local History。
  • 点击 Invalidate and Restart。IDE 将重启并重建所有索引。

3. Maven 配置问题

       你本地的 Maven 配置文件 (settings.xml) 可能配置了错误的镜像（mirror），导致无法连接到中央仓库。

解决方案：

• 检查 settings.xml 文件：
  • 进入 Settings -> Build, Execution, Deployment -> Build Tools -> Maven。
  • 查看 User settings file 的路径，找到这个文件。
  • 打开它，检查是否有 <mirror> 标签。如果有，确保这个镜像地址是可用的。作为测试，你可以暂时注释掉 <mirror> 部分，让它直连中央仓库。
• 清理本地 Maven 仓库：有时候本地仓库中的某些文件损坏也会导致问题。
  • 这是一个比较“激烈”但有效的方法。关闭 IntelliJ IDEA。
  • 找到你的本地 Maven 仓库（通常在用户目录下的 .m2/repository）。
  • 删除或重命名 repository 文件夹。
  • 重新打开 IntelliJ IDEA。它会重新下载所有需要的依赖和索引，但这会花费较长时间。

---

终极解决方案：如果以上方法都不行，使用命令行创建项目

       如果 IDE 内部始终无法加载原型列表，我们可以绕过它，直接使用 Maven 命令来创建项目，然后再用 IntelliJ IDEA 打开。

1. 打开你的系统终端（CMD、PowerShell 或 Linux/macOS 的 Terminal）。

2. 导航到一个你想要存放项目的目录下。

3. 运行以下命令来创建我们在上一个问题中讨论的 Jakarta EE 留言板项目：

   mvn archetype:generate ^-DgroupId=com.example ^-DartifactId=mini-message-board ^-DarchetypeGroupId=org.glassfish.jersey.archetypes ^-DarchetypeArtifactId=jakartaee8-webapp ^-DarchetypeVersion=2.3.1 ^-DinteractiveMode=false
   

   • 注意：在 Windows CMD 中，使用 ^ 作为换行符。在 PowerShell 或 Linux/macOS 中，使用 ` 或 \。你也可以把它们写在一行里。

4. 这个命令会下载所有需要的东西并创建一个名为 mini-message-board 的项目文件夹。

5. 项目创建成功后，回到 IntelliJ IDEA，选择 File -> Open...，然后选择刚刚创建的 mini-message-board 文件夹。IntelliJ IDEA 会自动识别它是一个 Maven 项目并加载它。

总结

1. "Create from archetype" 选项没了是正常的，这是新版 IDE 的设计。
2. Archetype 列表无法加载，90% 的可能性是网络问题（代理或防火墙）。
3. 如果网络没问题，尝试更新 Maven 索引和清理 IDE 缓存。
4. 作为最终手段，使用命令行 mvn archetype:generate 是一个万无一失的方法，可以帮你绕过 IDE 的问题快速创建项目。