Spring认证依赖报错求助：遗留项目加认证代码后启动失败

核心原因 #

出现ClassNotFoundException/NoClassDefFoundError是Spring Security OAuth2 Client依赖版本与项目全局Spring Security版本不匹配导致的：

• 项目全局指定spring-security.version为5.8.11，但单独给spring-security-oauth2-client硬编码了5.7.8版本
• 不同版本的Spring Security组件类结构存在差异，ClientRegistrationRepository在5.7.x和5.8.x的类定义/路径不兼容，引发类加载失败

解决方案 #

1. 统一Spring Security组件版本 #

删除spring-security-oauth2-client依赖中的硬编码版本，让它继承项目全局的spring-security.version，确保所有Spring Security组件版本一致：

<spring.version>5.3.36</spring.version>
<spring-security.version>5.8.11</spring-security.version>
<dependency>
  <groupId>org.springframework.security</groupId>
  <artifactId>spring-security-oauth2-client</artifactId>
  <scope>compile</scope>
</dependency>

2. 验证版本兼容性 #

Spring 5.3.x官方匹配的Spring Security版本是5.8.x，当前spring.version=5.3.36与spring-security.version=5.8.11的组合是兼容的，无需调整这两个全局版本。

3. 清理重构项目 #

• 执行mvn clean install（Maven项目）或对应构建工具的清理构建命令，确保依赖包被正确下载并替换旧版本
• 检查依赖树确认版本统一：

  mvn dependency:tree | grep spring-security-oauth2-client
  

额外检查点 #

• 确认OAuth2ClientConfig类中ClientRegistrationRepository的包路径导入正确，避免拼写或包名错误
• 检查容器（如Tomcat）的lib目录，删除可能存在的旧版本Spring Security jar包，避免依赖冲突

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