Eclipse中Maven依赖已下载但导入语句无法解析如何解决

问题现象 #

• 目标依赖已成功下载到本地Maven仓库目录
• 项目Java Build Path配置中Maven Dependencies容器正常显示
• 已尝试以下常规操作均未生效：
  • 命令行执行项目重构建后回到Eclipse刷新项目
  • Eclipse内直接执行项目重构建
  • Eclipse中执行Maven项目更新（Update Project）操作

相关现场截图 #

• 本地Maven依赖目录
• 目标依赖文件详情
• Java Build Path配置页
• 项目POM文件截图1
• 项目POM文件截图2
• 项目POM文件截图3

排查解决步骤（按生效概率从高到低执行） #

• 第一步：检查依赖scope配置错误
  打开POM文件定位到对应依赖的配置项：
  1. 若配置了<scope>test</scope>：该依赖仅对src/test/java目录下的测试代码生效，主源码目录src/main/java中的import必然报错，将scope修改为compile或直接删除scope标签（默认即为compile）即可。
  2. 若配置了<scope>provided</scope>：该依赖仅在测试、容器运行阶段加载，主代码编译时不会引入，按需调整scope即可。
  3. 若配置了<optional>true</optional>：该依赖不会被传递引入，若你是在依赖当前项目的其他模块中使用该依赖，需要在对应模块的POM中单独声明依赖。
• 第二步：清理Eclipse损坏的项目配置缓存
  关闭Eclipse，进入项目根目录，删除以下文件/文件夹：
  1. .classpath文件
  2. .project文件
  3. .settings整个文件夹
     重新打开Eclipse后，右键项目 -> Configure -> Convert to Maven Project，等待索引构建完成后检查import状态。
• 第三步：校验本地依赖文件完整性
  进入本地仓库中对应依赖的存储目录：
  1. 查找是否存在.lastUpdated后缀的损坏标记文件，若存在直接删除该依赖的整个文件夹，在项目根目录执行mvn clean install -U强制重新拉取依赖。
  2. 尝试解压目录下的jar包，若解压失败说明文件下载损坏，删除整个依赖目录后重新执行拉取命令即可。
• 第四步：对齐Eclipse Maven插件与本地Maven环境
  打开Eclipse配置页Window -> Preferences -> Maven：
  1. 进入Installations tab，确认选中的Maven为本地自行安装的版本，而非Eclipse自带的Embedded Maven。
  2. 进入User Settings tab，确认User Settings路径指向本地Maven使用的settings.xml文件，且配置文件中指定的本地仓库路径，和你实际存储依赖的目录完全一致。
• 第五步：排查依赖冲突
  在项目根目录执行命令：

  mvn dependency:tree -Dincludes=[目标依赖的groupId]:[目标依赖的artifactId]
  

  查看输出结果，若存在多个版本的该依赖被传递引入，在引入冲突版本的依赖项中添加<exclusions>标签排除冲突包即可。
• 第六步：检查源码目录配置
  右键项目 -> Build Path -> Configure Build Path -> Source，确认编写import语句的代码所在目录已被标记为源码目录，若目录被排除在编译路径外，即使依赖正常也无法解析类引用。

内容的提问来源于stack exchange，提问作者Harry