IntelliJ IDEA 中 Maven 依赖显示红色波浪线但 pom.xml 无错，主因是 IDEA 未同步依赖状态：需右键 Reload project、确认使用内置 Maven、检查模块依赖项、清理 .idea 和 *.iml 后重开项目、验证 scope 与 SDK 版本匹配、排查 Guava 等冲突库、删本地仓库后须先 mvn clean compile 再 Reload，并留意异步导入完成提示。
IntelliJ IDEA 里 Maven 依赖显示红色波浪线，但 pom.xml 没报错
这通常不是代码问题，而是 IDEA 没同步到最新依赖状态。Maven 本身可能已成功下载了 JAR，但 IDEA 的项目模型（Project Structure）没更新，导致编辑器无法解析类名，import 行就标红。
实操建议：
- 右键项目根目录 → Reload project（不是“Reimport”，那是旧版选项）
- 确保 IDEA 使用的是内置 Maven（
Settings → Build → Build Tools → Maven → Maven home path设为Bundled (Maven 3)），避免混用系统 Maven 导致本地仓库路径不一致 - 检查
File → Project Structure → Modules中每个 module 的Dependenciestab，确认Maven: xxx条目存在且无感叹号
执行 mvn clean compile 成功，但 IDEA 里仍标红 org.springframework.* 等常见包
说明依赖确实进了本地仓库（~/.m2/repository），但 IDEA 可能缓存了过期的 artifact 元数据，或解析时跳过了某些 scope（比如 test 或 provided）。
实操建议：
- 关闭 IDEA，删掉项目根目录下的
.idea文件夹和所有*.iml文件，再重新打开项目（IDEA 会重建索引） - 检查
pom.xml中对应依赖的<scope></scope>：若为test，则主源码（src/main/java）中引用会标红，这是正常行为 - 在
Settings → Build → Compiler → Java Compiler中确认Project bytecode version和Module SDK版本匹配，否则部分新版本依赖的 class 文件可能被跳过索引
mvn dependency:tree 能看到依赖，但 IDEA 不识别 com.google.guava:guava
Guava 是典型容易因版本冲突导致解析失败的库。IDEA 在构建依赖图时会做 conflict resolution，但它的 resolution 规则和 Maven 命令行不完全一致——尤其当父 POM 或 BOM 引入了多个 Guava 版本时，IDEA 可能选了被 exclude 的那个。
实操建议：
- 运行
mvn dependency:tree -Dverbose -Dincludes=guava，看实际 resolve 到哪个版本、是否被omitted for conflict - 在 IDEA 中打开
Maven tool window → execute goal，输入dependency:resolve，观察输出里guava的 resolved path 是否指向~/.m2/repository/com/google/guava/guava/...下真实存在的 JAR - 如果路径存在但仍是标红，尝试在
Settings → Build → Build Tools → Maven → Importing中勾选Import Maven projects automatically和Keep source folders order，然后再次 Reload
清理本地 Maven 库后 IDEA 依然加载不出新依赖
删了 ~/.m2/repository 后，Maven 会重新下载，但 IDEA 默认不会主动去扫描这些新文件——它只在 import 或 reload 时读取一次 metadata，之后靠缓存工作。你手动删库，等于让缓存和磁盘状态脱节。
实操建议：
- 删完
~/.m2/repository后，必须执行mvn clean compile（触发重下载），再在 IDEA 中执行Reload project；不能只 reload 不跑命令 - 如果用了 Nexus/Artifactory 私服，检查
~/.m2/settings.xml中<mirrorof></mirrorof>是否配置正确，IDEA 不会自动读取镜像配置里的认证信息，可能导致下载中断却无提示 - 留意 IDEA 控制台底部的
Build或Maven工具窗口是否有 “Could not transfer artifact ...” 类错误，这类网络失败往往静默发生，只在日志里留一行
最常被忽略的一点：IDEA 的 Maven import 过程是异步的，点击 Reload 后要等右下角弹出 “Import finished” 提示才算真正完成——很多人看到进度条消失就以为好了，其实后台还在解析 JAR 内的 classpath。
