添加@EnableAuthorizationServer致服务启动异常，现有注解配置可正常运行

看起来你遇到了Spring Boot项目中OAuth2配置冲突的问题——添加@EnableAuthorizationServer就启动报错，但用包含@EnableOAuth2Sso、@EnableOAuth2Client等注解的配置就能正常运行。我来帮你分析原因和解决方案：

核心原因分析 #

• 新旧OAuth2模块冲突
  @EnableAuthorizationServer属于旧版的Spring Security OAuth2模块（已被官方弃用），而你当前使用的@EnableOAuth2Sso、@EnableOAuth2Client如果基于新版Spring Security OAuth2或Spring Authorization Server，两者的配置逻辑、依赖体系完全不同，混用会导致过滤器链、身份验证管理器等核心组件冲突。
• 注解功能重叠冲突
  @EnableAuthorizationServer是用来搭建授权服务器的，而@EnableOAuth2Sso是实现客户端单点登录的，两者的配置逻辑会在Spring Security的过滤器链、端点映射上产生冲突（比如授权端点、令牌端点重复定义），触发启动异常。
• 依赖缺失或版本不匹配
  如果只加了@EnableAuthorizationServer但没引入对应的旧版spring-security-oauth2依赖，或者依赖版本与Spring Boot版本不兼容，也会导致启动失败。

针对性解决方案 #

方案1：如果需要搭建授权服务器（推荐使用新版） #

官方已弃用旧的@EnableAuthorizationServer，建议迁移到Spring Authorization Server（官方维护的新版授权服务器），无需再用@EnableAuthorizationServer注解，通过@Configuration手动配置核心组件：

@Configuration
public class AuthorizationServerConfig {

    // 配置客户端信息
    @Bean
    public RegisteredClientRepository registeredClientRepository() {
        RegisteredClient demoClient = RegisteredClient.withId(UUID.randomUUID().toString())
                .clientId("demo-client")
                .clientSecret("{noop}demo-secret") // {noop}表示不加密，生产环境需使用加密方式
                .clientAuthenticationMethod(ClientAuthenticationMethod.CLIENT_SECRET_BASIC)
                .authorizationGrantType(AuthorizationGrantType.AUTHORIZATION_CODE)
                .authorizationGrantType(AuthorizationGrantType.REFRESH_TOKEN)
                .redirectUri("http://localhost:8080/login/oauth2/code/demo-client")
                .scope(OidcScopes.OPENID)
                .scope("user:read")
                .build();

        return new InMemoryRegisteredClientRepository(demoClient);
    }

    // 配置授权服务器基础设置
    @Bean
    public AuthorizationServerSettings authorizationServerSettings() {
        return AuthorizationServerSettings.builder().build();
    }
}

同时引入新版依赖（以Maven为例）：

<dependency>
    <groupId>org.springframework.security</groupId>
    <artifactId>spring-security-oauth2-authorization-server</artifactId>
    <version>1.2.0</version> <!-- 版本需与Spring Boot匹配：Spring Boot 3.x用1.2.x，2.7.x用1.1.x -->
</dependency>

方案2：如果只需要客户端SSO功能 #

直接移除@EnableAuthorizationServer注解，保留你当前的配置即可：

@Configuration 
@EnableCaching 
@EnableOAuth2Sso 
@EnableWebSecurity 
@EnableOAuth2Client 
@SpringBootApplication 
@Import({ AppConvConfig.class, AppPropConfig.class, AppSecConfig.class }) 
@EnableAspectJAutoProxy(proxyTargetClass = true) 
@EnableTransactionManagement(proxyTargetClass = true) 
@EntityScan(basePackages = { BeanConstants.SCAN_PKG_JDBC_ENTITY }) 
@EnableJpaRepositories(basePackages = { BeanConstants.SCAN_PKG_JDBC_REPO }) 
@ComponentScan(basePackages = { BeanConstants.... })
public class YourApplication {
    // 业务代码
}

确保项目依赖中只包含客户端相关的OAuth2依赖（如spring-security-oauth2-client），避免引入旧版spring-security-oauth2模块。

方案3：排查依赖冲突（仅针对必须用旧版的场景） #

如果一定要使用旧版@EnableAuthorizationServer，需确保依赖版本完全匹配：

• Maven用户执行命令查看依赖树：mvn dependency:tree
• Gradle用户执行命令查看：gradle dependencies
• 排除所有冲突的新版OAuth2依赖，确保只引入旧版spring-security-oauth2、spring-security-jwt等依赖。

总结 #

先明确你的项目定位：是要做授权服务器还是OAuth2客户端，再选择对应的配置方案，避免混用新旧OAuth2模块的注解和依赖，就能解决启动异常的问题。

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