IDEA导入Maven项目的流程配置以常见问题解决

1. 前言

本文主要围绕着在IDEA中导入新Maven项目后的配置及常见问题解决来展开说说。相关的部分软件如下：

• IntelliJ IDEA  2021.1
• JDK 1.8
• Window
• apache-maven-3.8.1

2. 导入Maven项目及配置

2.1 导入Maven项目

下面介绍了直接打开本地项目和导入git上的项目两种导入Maven方式。

1）打开本地已有Maven项目：File > Open...  > 选择本地项目打开

2）导入 git 上的Maven项目

先复制GitHub项目的URL地址。

打开IntelliJ IDEA，点击File >  New >  Project from Version Control。

在弹框中输入GitHub项目的URL，选择项目保存地址，点击 Clone 按钮开始克隆过程。

2.2 maven配置

选择 File > Settings…

可在搜索框输入Maven，然后修改Maven的地址路径（Maven home path、User settings file、Local repository），然后点击Apply按钮再点击OK就可以了。

注意：要判断项目是内网项目还是外网项目，如果是内网项目，则在settings.xml文件中找到<mirrors>标签配置内网专用远程仓库镜像。

2.3 JDK配置

从Maven项目的pom.xml文件中可知该项目使用的是jdk1.8版本：

选择 File > Project Structure... ，然后修改项目名称、项目sdk版本、项目语言级别。

3. 常见问题

问题1：Cannot resolve org.springframework.kafka:spring-kafka:2.6.5

由于加载jar包报错，这里查看本地仓库对应的地址发现，存在 .lastUpdated 后缀的文件，这说明了该jar包存在损坏或不完整的情况，应直接删除两个后缀文件。然后重新Rebuild Project。

如果不是以上情况，具体看下链接的几种情况，逐个排除下。

IDEA中Maven无法下载jar包问题解决_maven无法下载依赖jar包-CSDN博客文章浏览阅读4.8k次，点赞23次，收藏39次。在项目中经常会遇到jar包无法下载的问题，可以根据以下几种方法进行排查。_maven无法下载依赖jar包https://blog.csdn.net/qq_39512532/article/details/136435214

问题2：本地仓库有jar，还从远程仓库拉取导致报错

问题描述：本地有需要的依赖包，但是maven还是会从远程仓库拉取，如果远程仓库没有包，或者无网络环境没法访问远程仓库，那就直接报错，走不下去了

本地仓库的每个依赖包都存在这样的文件：_remote.repositories，该文件记录了依赖的来源，记录了settings.xml中的id，如果settings.xml中的id发生了变化，就需要从远程仓库重新获取依赖。

解决方法1：直接删除_remote.repositories文件，单个删除或者全部删除都可以。

解决方法2： 复制本地的repository仓库，然后修改settings.xml的远程仓库地址为本地仓库地址，maven就会把本地仓库当做远程仓库。

<mirror>
        <id>nexus-aliyun</id>
        <mirrorOf>central</mirrorOf>
        <name>Nexus aliyun</name>
        <url>file://D:/Repository/</url>
</mirror>

问题3：java: Compilation failed: internal java compiler error

原因：由于idea设置的JDK版本和项目配置不同导致的。

解决方法：先查看项目中配置的JDK版本，再去idea的配置中去同步版本设置。具体步骤如下：

1）查看项目配置的JDK版本：pom.xml文件

2）IDEA 检查“Java Compiler"的配置：File > Setting > Build,Execution,Deployment  > Compiler > Java Compiler

3）IDEA 检查 “Project” 的配置：File > Project Structure > Project Setting > Project

4）IDEA 检查“Modules --> Sources"的配置：File > Project Structure > Project Setting > Modules > Sources

5）IDEA 检查“Modules --> Dependencies"的配置：File > Project Structure > Project Setting > Modules > Dependencies

问题4：Cannot resolve symbol 'OkHttpClient'

查看有正常引入依赖，且本地仓库存在该jar包，但import灰色且引入的类有红色曲线。项目rebuild、install、启动都正常，没报错，未影响项目可忽略问题。

问题5：版本不兼容导致

‌IDEA工具版本、JDK版本、Maven版本三者之间有关联，且不匹配可能会导致程序启动不了‌。具体来说：

1. ‌IDEA版本与JDK版本的关系‌：不同版本的IDEA支持不同版本的JDK。例如，IntelliJ IDEA 2022.3支持Java 7到19的版本，而IntelliJ IDEA 2020.2则只支持到Java 15‌。如果IDEA版本过高而JDK版本过低，或者反之，都可能导致无法运行代码。解决这类问题的方法包括降低JDK版本或升级IDEA版本，或者在IDEA中切换到较低版本的JDK路径‌。

2. ‌IDEA版本与Maven版本的关系‌：不同版本的IDEA与Maven的兼容性也有所不同。例如，IntelliJ IDEA 2021.1版本与Maven 3.9.x系列存在冲突。（之前就遇到过！！！）

3. JDK版本与Maven版本的关系‌：虽然JDK和Maven的直接兼容性问题较少，但JDK版本的更新可能会影响Maven的运行。例如，Tomcat 10.x系列版本要求JDK 11或以上版本，而Tomcat 9.0系列则支持JDK 1.8‌2。因此，确保JDK和Tomcat的版本匹配也是必要的。