Eclipse导入Maven多模块项目后依赖识别异常、模块重复显示如何修复

前置清理（必须先做，避免旧配置冲突） #

• 从Eclipse工作空间移除所有相关的父工程、子模块项目，移除时不要勾选删除本地磁盘文件选项
• 进入本地项目的根目录，删除父工程和所有子模块下的.project、.classpath文件，以及.settings文件夹，彻底清除之前的错误Eclipse配置

基础环境校验 #

• 确认Eclipse已安装Lombok插件：打开Eclipse顶部菜单Help > About Eclipse IDE，查看底部说明栏是否有Lombok相关标识，未安装的话先完成Lombok安装并重启Eclipse
• 确认Eclipse的M2E（Maven Integration for Eclipse）插件已正常启用，无需额外安装旧版eclipse:eclipse插件相关依赖

重新导入项目 #

• 选择Eclipse顶部菜单File > Import > Maven > Existing Maven Projects
• 根目录选择本地克隆的项目根文件夹（父工程所在目录），等待Eclipse扫描出所有父工程和子模块后，全选所有条目直接导入，不要勾选多余的工作集配置选项

项目配置同步 #

• 右键点击父工程，选择Maven > Update Project
• 在弹出的配置窗口中，全选所有父、子模块，勾选以下选项后点击确认：
  • Force Update of Snapshots/Releases
  • Update project configuration from pom.xml
  • Refresh workspace resources from local filesystem
• 逐个检查子模块的项目 facets 配置：右键模块 > Properties > Project Facets，确认Java版本与pom.xml中maven-compiler-plugin配置的source/target版本完全一致，应用配置后保存

异常问题修复 #

• 如出现模块重复显示问题：切换至Package Explorer视图即可正常展示层级，或打开Project Explorer的筛选菜单（视图右上角小三角），关闭多余的嵌套项目展示规则即可
• 如仍无Maven Dependencies项：右键模块 > Properties > Maven，确认Resolve dependencies from Workspace projects已勾选，再次执行Maven Update操作即可

注意事项 #

• 不要再使用mvn eclipse:eclipse命令，该命令生成的配置与当前Eclipse默认的M2E插件存在冲突，会导致依赖识别异常
• 建议在父工程pom中统一配置maven-compiler-plugin的Java版本，避免每次Update Project后版本自动重置为默认值

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