构建 Maven 项目时可能遇到的问题

本篇是针对这篇文章中可能出现的问题进行总结，并给出解决方法，都是自己亲自踩过的坑，现在记录下来，防止以后再犯错误。

1. Maven 自动下载依赖后，在本地仓库中找不到

经过：

• 本地仓库的地址设置为 K:\environment\apache-maven-3.9.6\maven-repo ；
• 并希望将 Maven 自动下载的依赖保存在这个本地仓库中；
• 但是发现下载依赖结束后，在本地仓库中找不到依赖。

原因：在 IDEA 的 Settings 中 Maven 本地仓库默认的位置为：C:\Users\Sun3285\.m2\repository ，下载的依赖保存在了这里。

改正：可以将这里改为设置好的本地仓库，但是重新建立项目时，仍需要再次修改

建议按下面的方式进行修改（在 IDEA 的一开始进行自定义设置），一劳永逸，重新建立项目时，本地仓库就已经是设置好的了

2. 运行时报错如下：Error: java 不支持发行版本 5

经过：运行 Java 程序时，报错：Error: java 不支持发行版本 5 。

原因：本地配置的 JDK 和 IDEA 默认的 JDK 不匹配。

改正：检查以下 5 个位置，将 JDK 的配置保持一致，就可以了。

• 项目结构 Project Structure 中

• 设置 Settings 中

3. 创建 Maven 项目后 pom.xml 文件为空

经过：选择 JDK 21 时，创建 Maven 项目后 pom.xml 文件为空。

原因：JDK 版本过高。

改正：降低 JDK 的版本，将 JDK 21 降为 JDK 17，就解决了。

4. 在 Settings 中 Update 了阿里云远程仓库，导致整个项目不能运行

经过：因为好奇，在 Settings 中 Update 了阿里云远程仓库，导致整个项目不能运行。

原因：这是阿里仓库不支持 index（索引）导致的，当 update 时，就是在 update index，所以就会出错。

改正：

• 方法一：换成支持 index 的镜像，或者使用 Apache 的 Central仓库（中央仓库），但是这个较慢；
• 方法二（推荐）：不用理会这个问题，因为再次创建一个新的项目时，不会影响任何操作，Maven 依旧可以照常使用。