这种情况我在日常开发中碰到过N次，大多是IDE缓存、索引或者pom本身的小问题导致的，下面给你列几个最靠谱的排查和解决方向：

1. 先试试刷新Maven索引和清除IDE缓存（最常用的解决方法） #

IntelliJ的Maven索引经常会“抽风”，哪怕依赖已经躺在本地仓库，它就是没识别到。按这个步骤来：

• 打开右侧边栏的Maven面板，点左上角那个圆形箭头的刷新按钮，让IDE重新解析pom并同步依赖
• 如果刷新没用，直接清缓存：File → Invalidate Caches...，勾选Clear file system cache and local history，然后重启IDE。重启后IDE会重新构建整个项目的索引，这招亲测能解决80%的标红问题

2. 检查pom.xml本身的语法/配置错误 #

有时候依赖确实下载完了，但pom里藏着小错误，比如：

• 鼠标悬停在红色标线位置，IDE会弹出具体错误提示（比如<dependency>标签没闭合、groupId/artifactId拼写错、插件配置参数不合法）
• 有没有重复声明同一个依赖？或者版本冲突？可以通过Maven面板的Dependencies标签查看冲突的依赖项
• 确认XML语法合规，比如标签嵌套是否正确，特殊字符（比如&）有没有转义成&

3. 本地Maven仓库的依赖文件损坏 #

偶尔会出现依赖显示“下载完成”，但本地仓库里的jar包或者pom文件其实损坏了：

• 找到本地Maven仓库的对应依赖目录（默认是~/.m2/repository，如果自定义过路径就找你设置的那个），把整个依赖文件夹删掉
• 回到IntelliJ，再次点击Maven面板的刷新按钮，让IDE重新下载该依赖

4. 检查IntelliJ的Maven配置是否正确 #

有时候IDE用的Maven不是你本地的，或者settings.xml配置不对：

• 打开File → Settings → Build, Execution, Deployment → Build Tools → Maven：
  • 确认Maven home directory是你本地安装的Maven路径（如果用IntelliJ自带的也可以，但要确保和本地仓库配置匹配）
  • 确认User settings file指向正确的settings.xml，里面的镜像、仓库配置没问题
  • 确认Local repository路径和你实际的本地仓库完全一致

5. 镜像仓库同步问题导致依赖元数据不完整 #

如果上面的方法都没用，可能是你用的Maven镜像仓库同步不及时，导致依赖的元数据缺失：

• 去本地仓库看看对应依赖文件夹里有没有.lastUpdated文件，如果有，说明之前下载失败过
• 换个靠谱的Maven镜像（比如阿里云镜像），在settings.xml里配置好，然后重新下载依赖

如果按照上面的步骤排查完还是有问题，把红色标线位置的具体错误提示贴出来，更容易精准定位问题。

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