Maven编译Spring项目提示org.springframework.stereotype等包不存在

可能的原因 #

• 本地Maven仓库中对应版本的Spring依赖包损坏。mvn dependency:tree仅校验依赖坐标的存在性，不会校验jar包本身的完整性，下载过程中出现的网络波动会导致jar包残缺，触发类找不到异常。
• 本地JDK版本与项目编译要求不匹配。2019-2020年的Spring项目普遍基于JDK8开发，若本地默认JDK为11及以上版本，且pom中未指定对应编译参数，会出现依赖解析异常。
• Maven激活的profile与旧环境不一致。旧环境可能通过指定profile完成依赖版本仲裁，本地未激活对应profile的情况下，会出现依赖版本不匹配的问题。
• IDE缓存损坏。若你是通过IDE触发编译，IDE的索引缓存损坏时，即使Maven依赖配置完全正确，也会误报找不到类的错误。
• Maven镜像源配置异常。若本地settings.xml配置的私有镜像源中对应版本的Spring依赖包残缺，会导致拉取到无效的jar文件。

解决方案 #

• 首先执行mvn clean compile通过命令行编译，若命令行编译成功，说明是IDE缓存问题：IDEA可通过File → Invalidate Caches重启解决，Eclipse可执行Project → Clean清理缓存。
• 若命令行编译也报错，先清理本地Maven仓库中对应版本的Spring依赖：找到本地仓库的org/springframework路径，删除spring-context对应版本的文件夹，重新执行mvn clean install拉取依赖。
• 核对JDK版本：执行java -version和mvn -v，确认Maven使用的JDK版本与项目要求一致，同时检查pom中maven-compiler-plugin的配置，确认source、target参数与旧环境匹配，JDK8的参考配置如下：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
    </configuration>
</plugin>

• 核对激活的Maven profile：执行mvn help:active-profiles，确认当前激活的profile与旧环境一致，避免依赖版本仲裁异常。
• 检查Maven镜像源配置：确认settings.xml中配置的镜像源存在对应版本的完整Spring依赖，可临时切换为公共镜像源重试。

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