项目爆红怎么办 - 我的学习小铺

刚拉下公司项目代码，满怀期待地用 IDEA 打开，结果映入眼帘的是漫山遍野的红色报错……先别慌！深呼吸！

这几乎是每个开发者都会经历的“下马威”。通常情况下，代码本身并没有错，绝大多数的“爆红”都是因为本地环境配置、构建工具或缓存同步出现了偏差。

按照以下四个维度的排查清单按图索骥，帮你快速将项目“由红转绿”。

一、JDK 版本不匹配#

很多时候，项目的地基没打对。如果 IDEA 使用的 JDK 版本和项目实际要求的版本不一致，就会出现大量的基本语法报错。

排查动作：统一全局 JDK 配置 请依次检查以下两个地方，确保版本号（如 JDK 8、JDK 11 等）与项目要求完全一致：
1. 项目结构设置： 菜单栏 File -> Project Structure -> 检查 Project SDK 和 Modules SDK。
2. 编译器设置： 菜单栏 File -> Settings -> Build, Execution, Deployment -> Compiler -> Java Compiler -> 检查 Target bytecode version。

依赖管理工具（Maven/Gradle）的状态异常，是导致项目爆红的“重灾区”。请按顺序检查：

现象： java 文件夹不是蓝色的，resources 文件夹没有带有金条图标。
解决： 右键对应的目录 -> Mark Directory as -> 将 java 标记为 Sources Root，将 resources 标记为 Resources Root。

现象： 依赖明明都配置了，但依然飘红。
解决： 构建工具可能卡在旧缓存里了。执行 clean 命令清除历史，再重新构建（例如在 Maven 面板双击运行 clean，然后运行 install 或 compile）。

这是最常见的情况，需要分情况讨论：

情形 A：Jar 包在公司的 Maven 私仓里
- 排查 1： 你的 IDEA 是否配置了正确的 settings.xml？（里面需要包含公司的私服地址和镜像配置）。
- 排查 2： 去私仓后台看一眼，包确实存在，但版本号对得上吗？（特别是 SNAPSHOT 快照版本，可能没有拉取到最新）。
情形 B：Jar 包不在 Maven 私仓里
- 本地依赖： 包可能直接扔在项目的 lib 目录下了，需要手动添加本地依赖（通过 pom 的 scope=system 引入）。
- 模块依赖： 这个 Jar 包其实是公司另一个基础模块的源码。你需要先找到那个模块，在本地跑一遍 mvn clean install，把它装到你自己的本地仓库里。

现象： 实体类上明明加了 @Data 等注解，但其他类调用 get/set 方法时依然报错找不到。
解决：
1. 检查 IDEA 的 Lombok 插件版本，确保与项目依赖中的 Lombok 版本兼容，必要时更新插件。
2. 在 IDEA 的 Settings -> Build, Execution, Deployment -> Compiler -> Shared build process VM options 中添加参数：-Djps.track.ap.dependencies=false。

IDEA 为了让你搜索和跳转更丝滑，会在后台建立海量索引。一旦这些索引文件损坏，就会出现“薛定谔的报错”（代码没问题，运行也正常，但就是满屏红线）。

终极杀招：清除 IDEA 缓存
1. 点击顶部菜单栏 File -> Invalidate Caches...
2. 在弹出的对话框中，将前四个选项全部勾选（包括 Clear file system cache and Local History 等）。
3. 点击 Invalidate and Restart，耐心等待 IDEA 重启并重新建立索引。

如果经历了上面三步的洗礼，依然有零星报错，那很可能是代码层面真的少东西了。

排查动作：确认是否有人“漏交”代码
- 现象： 提示缺少某个类、或是某个类里缺少刚刚调用的新方法。
- 解决： 看看 Git 提交记录，最近是不是有同事刚推过代码？大概率是这位同事在 Commit 时漏选了某些新增的类文件。这时候不用怀疑自己，大胆去群里艾特对应同事补充提交代码即可。

💡 总结排查口诀： 遇到爆红莫心慌，排查顺序记心上：一查 JDK 环境，二看 Maven 依赖，三清 IDEA 缓存，最后核对 Git 同步。