解决 IntelliJ IDEA Maven 项目 JDK 版本自动变为 1.5 的问题

一、问题描述

在使用 IntelliJ IDEA 创建 Maven 项目时，经常会遇到一个问题：项目的默认编译版本被设置为 JDK 1.5，即使系统中安装的是更高版本的 JDK。这不仅会导致编译时出现警告，还可能引起兼容性问题。每次手动修改编译版本后，项目重新加载或更新 Maven 依赖时，版本又会自动变为 1.5。

二、解决方案

方法一：在 pom.xml 中配置编译器插件

在项目的 pom.xml 文件中添加 maven-compiler-plugin 插件，明确指定源代码和目标字节码版本。例如，如果你想设置为 JDK 1.8，可以这样做：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.8.1</version> <!-- 选择一个稳定的版本 -->
      <configuration>
        <source>1.8</source>
        <target>1.8</target>
      </configuration>
    </plugin>
  </plugins>
</build>

方法二：在 IntelliJ IDEA 中手动设置

如果 pom.xml 配置无效，可以在 IntelliJ IDEA 中手动设置项目的 JDK 版本：

1. 使用快捷键 Ctrl + Alt + S 打开 Settings 对话框。
2. 导航到 Build, Execution, Deployment -> Java Compiler。
3. 将 Target bytecode version 手动设置为你需要的版本，如 1.8。
4. 点击 Apply 和 OK 保存设置。

方法三：设置 Maven 全局配置

如果希望所有新创建的 Maven 项目都使用指定的 JDK 版本，可以在 Maven 的全局配置文件 settings.xml 中进行设置：

1. 打开 Maven 安装目录下的 conf 文件夹，找到 settings.xml 文件。
2. 在 <profiles> 标签内添加一个配置段落，例如如果你希望设置 JDK 版本为 1.8，则添加如下内容：

<profile>
  <id>jdk-1.8</id>
  <activation>
    <activeByDefault>true</activeByDefault>
    <jdk>1.8</jdk>
  </activation>
  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
  </properties>
</profile>

3. 保存文件并重启 IntelliJ IDEA。

方法四：添加父级依赖

如果 Maven 项目中没有 <parent> 标签，也可以尝试添加一个父级依赖，这通常会帮助正确设置编译器版本。例如，对于一个 Spring Boot 项目，可以添加如下依赖：

<parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>2.5.4</version>
</parent>

方法五：在项目结构中设置

1. 使用快捷键 Ctrl + Alt + Shift + S 或者通过 File -> Project Structure... 打开项目结构对话框。
2. 在左侧选择 Project，在右侧的 Project SDK 下拉菜单中选择已安装的 JDK 版本。
3. 在左侧的窗口中，选择 Modules，然后在右侧的 Dependencies 选项卡中，选择项目的模块。
4. 在 Module SDK 下拉菜单中选择已安装的 JDK 版本。
5. 点击窗口底部的 Apply（应用）按钮，然后点击 OK（确定）按钮关闭窗口。

三、注意事项

1. 全局设置优先级：全局设置会影响所有项目，因此请谨慎使用。
2. IDEA 缓存清理 ：有时 IDEA 的缓存可能导致设置失效，可以尝试清理缓存（File -> Invalidate Caches / Restart）。
3. Maven 版本：确保使用的 Maven 版本支持你所设置的 JDK 版本。
4. 项目继承 ：如果项目中已经有 <parent> 标签，确保父项目的编译器版本也设置正确。

四、总结

通过上述方法，你可以有效地解决 IntelliJ IDEA 中 Maven 项目 JDK 版本自动变为 1.5 的问题。