使用Spring Boot集成OAuth2遇依赖版本相关异常求助

这个问题我之前帮很多新手排查过，本质就是Spring核心依赖版本不匹配导致的方法找不到错误，别担心，一步步来就能解决：

1. 先确认Spring Boot父依赖的正确性 #

Spring Boot的spring-boot-starter-parent会自动管理所有Spring生态依赖的版本，这是避免版本冲突的核心。请检查你的pom.xml是否有正确配置父依赖，并且不要手动指定Spring核心组件（比如spring-core、spring-context）的版本：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <!-- 选择一个稳定的Spring Boot版本，比如2.7.x或3.x系列，根据你的OAuth2需求选择 -->
    <version>2.7.15</version>
    <relativePath/> <!-- 让Maven自动从仓库查找父依赖 -->
</parent>

2. 规范引入OAuth2相关依赖 #

不要直接引入单独的spring-security-oauth2依赖，而是使用Spring Boot官方提供的starter，它会自动匹配兼容的版本：

<!-- 如果是OAuth2客户端场景 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-oauth2-client</artifactId>
</dependency>

<!-- 如果是OAuth2资源服务器场景 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-oauth2-resource-server</artifactId>
</dependency>

手动引入旧版本的spring-security-oauth2是新手最容易踩的坑，会直接导致和Spring Boot管理的Spring核心版本冲突。

3. 排查依赖树中的版本冲突 #

用Maven命令生成依赖树，找出引入了不兼容版本的依赖：

mvn dependency:tree

在输出结果中搜索spring-core，如果发现有多个版本（比如一个是Spring Boot管理的5.3.x，另一个是某个第三方依赖引入的5.2.x），就需要在对应的依赖中排除旧版本的spring-core：

<dependency>
    <groupId>冲突依赖的groupId</groupId>
    <artifactId>冲突依赖的artifactId</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>

4. 清理并重新构建项目 #

有时候本地缓存的依赖会有残留问题，执行以下命令强制清理并重新下载依赖：

mvn clean install -U

-U参数会强制Maven更新所有快照和依赖版本。

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