IDEA 每次重启 Maven 依赖 jar 包丢失 / 爆红完整解决方案
现象：第一次刷新 Maven 一切正常；关闭 IDEA 再重启打开项目，依赖报红、找不到 jar 包，本地.m2/repository文件夹里面 jar 文件实际存在。
一、优先修正 Maven 全局配置（根治最高频原因）
1. 核对 Maven 三项路径（每一项必须完全一致）
打开设置：File → Settings → Build, Execution, Deployment → Build Tools → Maven
- Maven home path ：选择你本机解压的 Maven，不要选 IDEA 自带内置 Maven
- User‑settings file ：勾选
Override，手动指定settings.xml完整路径 - Local repository ：勾选
Override，指定你的本地仓库路径，不要留空
⚠️ 关键点：三项路径全部手动锁定，不要交给 IDEA 自动探测；重启后就不会随机切换仓库。
2. 开启自动导入
同一 Maven 设置页面，勾选：
- ✅ Import Maven projects automatically（自动导入 Maven 项目）
- ✅ Automatically download Sources and Documentation
- 下方
Maven‑Importing→ VM options for importer，JDK 版本和项目 SDK 版本保持一致（项目用 JDK8 这里就用 JDK8，SpringBoot3 选 JDK17）GitHub
二、修复 IDEA 索引缓存（最常见）
方案 A（新版 IDEA2026.2）
File → Repair IDE，一步步修复索引，不需要清空全部项目缓存JetBrains。
方案 B（通用）
File → Invalidate Caches... 勾选：Clear file system cache and local history → Invalidate and Restart
重启后等待完整索引构建完成，不要中途关闭。
三、项目模块 Classpath 丢失（重启就丢依赖）
File → Project Structure → Modules- 选中你的模块 →
Dependencies检查依赖列表，看重启后 Maven 库是否消失。
- 如果消失：右键项目 pom.xml → Maven → Reload Project；刷新后依赖回来。
- 每次重启都消失：.idea 文件夹缓存损坏。
终极重置项目配置（多模块项目非常有效）
-
关闭 IDEA 2. 进入项目根目录，手动删除：
.idea文件夹
所有模块下target文件夹
*.iml文件 -
重新打开 IDEA，选择
Open打开根 pom.xml，等待重新导入 Maven 项目，生成全新.iml 和.idea 配置文件。
⚠️不要用 IDEA 从最近列表打开；优先选择 Open，选中项目 pom。
四、settings.xml 仓库镜像问题（隐性坑）
确认settings.xml配置阿里云镜像，并且没有错误的私有仓库、异常 profile。
<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>central</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>配置完后，设置页面 Maven→Repositories，选中本地仓库点Update刷新索引缓存。
五、其他排查点
- 不要开启省电模式 Power Save Mode：开启后 IDEA 停止索引依赖，看起来 jar 丢失；右下角检查灯泡图标。
- 多模块父工程问题：必须从根目录 pom 打开项目，不要单独打开子模块，子模块单独打开会丢失父 pom 依赖。
- scope 范围：依赖写了
<scope>provided</scope>，IDEA 运行时会报找不到类，不是重启丢失。 - 本地仓库文件损坏：删除依赖文件夹下
_remote.repositories、.lastUpdated文件，重新 reload 下载。
快速处理步骤清单（按顺序执行）
- 锁定 Maven 三项路径，开启自动导入 2. 删除项目
.idea、iml文件，重新导入项目 3. 清除 IDEA 缓存重启 4. 刷新 Maven 项目（右侧 Maven 面板左上角循环箭头 Reload All Maven Projects）