IDEA编译报错：Error:(3, 28) java: 程序包com.alibaba.fastjson不存在

背景

日常 Java 项目开发中，经常会使用第三方依赖库，例如 fastjson 来处理 JSON。
项目初期一切正常，编译运行都没有问题。但有时候在 重启 IDEA 或 更新依赖 后，可能会突然出现一些诡异的编译错误。

最近我就遇到了一个典型问题：项目原本运行良好，突然编译时报错，提示 fastjson 包不存在。

问题现象

在 IDEA 中编译项目时，报如下错误：

Error:(3,28) java: 程序包com.alibaba.fastjson不存在

即便在 pom.xml 中已经引入了 fastjson 依赖，IDEA 仍然提示找不到对应包。

原因分析

出现这种问题的原因有以下几种可能：

1. IDEA 缓存问题
   IDEA 没有正确刷新 Maven 依赖，导致编译器无法识别该包。

2. Maven 依赖未正确下载
   本地 Maven 仓库（~/.m2/repository）中的依赖可能损坏或缺失。

3. 依赖被作用域限制
   如果在 pom.xml 中将依赖标记为 <scope>provided</scope>，编译阶段不会引入。

4. 项目 SDK 配置问题
   IDEA 的 Project SDK 或 Module SDK 没有正确设置，导致依赖无法编译。

解决方案

1. 刷新 Maven 依赖

   命令行执行：

   mvn clean install -U
   

   （我自己就是通过这个命令解决的）

2. 清理本地仓库，重新下载依赖
   如果依赖损坏，可以删除本地仓库对应的目录：

   rm -rf ~/.m2/repository/com/alibaba/fastjson
   mvn clean install
   

3. 检查 pom.xml 中依赖是否正确

   <dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>1.2.83</version>
   </dependency>
   

   • 确保没有配置 <scope>provided</scope>

4. 检查 IDEA SDK 配置
   进入 File → Project Structure，确认：

   • Project SDK 已设置
   • Modules 中每个模块都绑定了正确的 SDK

总结

这个问题的本质是 IDEA 没有正确加载 Maven 依赖。
最简单有效的办法就是执行：

mvn clean install -U

重新下载依赖并刷新缓存，基本可以解决大多数类似问题。