IDEA工程运行时总是报xx程序包不存在实际上包已导入(问题分析及解决方案)

问题背景

在使用 JetBrains 旗下的 Java IDE 工具 IntelliJ IDEA 进行项目开发时，有时会遇到一个问题：在导入了某些依赖库后，运行程序时提示某些类找不到或某些程序包不存在，但实际上这些包已经被正确导入了。

问题原因

这是因为 IntelliJ IDEA 默认会在编译、运行时根据 Maven、Gradle 或自己所设置的依赖路径自动导入相关依赖，而在某些情况下会出现依赖版本不一致、缓存文件失效等原因导致 IDEA 没有正确地导入相应的依赖包。

问题解决方案

方案一：刷新缓存和重建依赖索引

在 IDEA 中，如果出现了依赖包已导入但找不到的问题，可以尝试进行如下操作：

1. 关闭 IDEA
2. 删除项目目录下的 .idea 目录，这会删除 IDEA 缓存文件并重置当前项目的依赖索引。
3. 删除项目目录下的 target 目录（如果有的话）。
4. 重新启动 IDEA，并根据需要重新构建依赖关系。
5. 点击 IDEA 菜单栏中的 "File -> Invalidate Caches / Restart..."，选择 "Invalidate and Restart" 选项进行缓存清理和 IDEA 重启操作。

这种方法能清理掉被缓存的错误信息并且能解决 IDEA 没有正确导入依赖的问题。

方案二：手动配置依赖包路径

如果使用了 Maven 或 Gradle，可以尝试手动配置项目的依赖包路径，避免依赖版本不一致导致的无法启动或者报错的问题。方法如下：

1. 在 IDEA 的项目设置中找到 "Libraries" 选项，并点击 "New Project Library" 来手动添加依赖库路径。
2. 通过 .jar 包文件自定义项目所需的外部依赖库，这个可以手动导入jar包，但要注意相关的依赖库是否能够导入IDEA中。

示例说明

1. 添加外部 .jar 包示例

假设我们的项目需要使用 mysql 数据库，我们可以在 Maven 或 Gradle 项目中加入该依赖：

<!-- pom.xml -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.15</version>
</dependency>

这样在执行 mvn clean install 时，该依赖库会被自动下载并加入项目中。但有时候 IDEA 可能会出现无法识别，报错等问题。我们可以手动下载依赖包，然后在项目设置中根据如下命令进行添加：

Project Structure -> Libraries -> New Project Library -> JARs or directories -> 添加已经下载好的 mysql-connector-java-8.0.15.jar 文件

1. 重建依赖索引示例

有时候我们在执行 mvn clean install 的时候，会遇到依赖依赖不能被maven正确加载的问题，这时候我们可以在IDEA内进行重建依赖索引操作。

File -> Invalidate Caches / Restart… -> Invalidate and Restart

这时候 IDE 会自动清除 Maven 下载的依赖包和相关缓存信息，重新下载所有依赖并重新构建索引信息。

总结

以上是解决 IDEA 依赖包已导入但找不到的问题的两种常见方法，当然具体情况具体分析。