IntelliJ IDEA中Spring Boot项目编译报错‘package does not exist’求助

根据你描述的情况——编辑器能识别类但编译时找不到包，大概率是构建工具的依赖配置或者打包环节出了问题，给你几个具体的排查点：

• 检查依赖作用域是否正确
  如果你用Maven，确保公共库的依赖作用域是compile（默认就是，但别改成provided/test）；如果是Gradle，要用implementation而不是compileOnly/testImplementation。编辑器会加载所有依赖，但编译阶段只会读取对应作用域的依赖，这是最常见的"编辑器正常但编译报错"的原因。

• 验证公共库jar的实际内容
  把你打包好的公共库jar解压，看看里面有没有org/XXXX/XXX/lib/config/Config.class这个文件。有时候打包配置出错（比如Maven的maven-jar-plugin没包含正确的源目录，或者Gradle的jar任务过滤了类文件），导致jar里根本没有这个类，自然编译找不到。

• 直接检查构建工具的配置文件
  别只依赖IDEA的图形化设置，打开Spring Boot模块的pom.xml（Maven）或build.gradle（Gradle），确认公共库的依赖声明是正确的：

  • 如果是项目内模块依赖，要确保依赖的groupId、artifactId、version和公共库完全一致，或者用模块依赖的方式（比如Maven里的<module>）；
  • 如果是本地jar依赖，要确认路径没有写错，Maven的话尽量把jar安装到本地仓库（执行mvn install）再引入，避免用system作用域带来的问题。

• 清理缓存并重新构建
  IDEA的缓存偶尔会抽风，先执行File -> Invalidate Caches... -> Invalidate and Restart重启IDE。然后手动用构建工具清理重新构建：Maven跑mvn clean install，Gradle跑./gradlew clean build，彻底清除旧的编译产物和缓存。

• 检查多模块项目的依赖关联
  如果公共库是项目内的模块，Spring Boot模块应该直接依赖这个模块，而不是手动引入打包好的jar。这样构建工具会自动保证编译顺序（先编译公共库，再编译Spring Boot），避免出现依赖未就绪的情况。比如Maven的父pom里要包含所有子模块，Spring Boot的pom里要明确依赖公共模块。

• 查看详细编译日志找线索
  开启构建工具的debug模式，比如Maven用mvn clean compile -X，Gradle用./gradlew compileJava --debug，查看编译阶段到底加载了哪些依赖，有没有公共库的jar，或者有没有依赖冲突导致它被排除了，日志里会有明确的提示。

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