Spring Cloud Gateway整合OAuth2遇Bean错误及OpenAPI授权集成咨询

这个错误核心是Spring Cloud Gateway（WebFlux响应式环境）与Servlet风格的Security配置冲突，导致ServerHttpSecurityConfiguration（WebFlux安全核心配置类）无法正常初始化。以下是针对性的排查修复方案：

1. 修正OAuth2安全配置类 #

确保配置完全适配WebFlux环境，避免使用Servlet相关的注解和基类：

• 错误写法（Servlet环境）：

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    // Servlet风格的配置逻辑
}

• 正确写法（WebFlux环境）：

@Configuration
public class SecurityConfig {
    @Bean
    public SecurityWebFilterChain springSecurityFilterChain(ServerHttpSecurity http) {
        http
            .authorizeExchange(exchanges -> exchanges
                // 开放OpenAPI相关路径无需授权
                .pathMatchers("/v3/api-docs/**", "/swagger-ui/**", "/swagger-ui.html").permitAll()
                // 其余所有请求必须授权
                .anyExchange().authenticated()
            )
            .oauth2ResourceServer(oauth2 -> oauth2
                .jwt(jwt -> jwt
                    .jwtDecoder(jwtDecoder())
                )
            );
        return http.build();
    }

    @Bean
    public JwtDecoder jwtDecoder() {
        // 替换为你的认证服务器issuer地址
        return NimbusJwtDecoder.withIssuerUri("https://your-auth-server/realms/your-realm").build();
    }
}

注意：WebFlux环境下不需要@EnableWebSecurity注解，直接定义SecurityWebFilterChain Bean即可。

2. 清理依赖冲突 #

确保依赖仅包含WebFlux环境所需的Security组件，避免混入Servlet依赖：

• 正确的Maven依赖组合：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-oauth2-resource-server</artifactId>
</dependency>
<!-- OpenAPI WebFlux适配依赖 -->
<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-starter-webflux-ui</artifactId>
    <version>2.2.0</version> <!-- 使用与Spring Boot版本兼容的版本 -->
</dependency>

• 错误依赖组合需移除：
  移除spring-boot-starter-security（Servlet环境核心依赖）、spring-security-web等Servlet相关包。

3. 修正YAML配置 #

确保OAuth2资源服务器配置正确：

spring:
  security:
    oauth2:
      resourceserver:
        jwt:
          issuer-uri: https://your-auth-server/realms/your-realm
          # 可选：若认证服务器JWKS路径非默认，手动指定
          jwk-set-uri: ${spring.security.oauth2.resourceserver.jwt.issuer-uri}/protocol/openid-connect/certs

如果堆栈包含NoSuchBeanDefinitionException或BeanCreationException，大概率是以下情况：

• 配置类误用了@EnableWebSecurity注解，触发Servlet环境的Security Bean初始化，与WebFlux冲突。
• 依赖中同时存在spring-security-web（Servlet）和spring-security-webflux，导致Bean定义冲突。
• JwtDecoder初始化失败（如issuer-uri不可达），连锁影响ServerHttpSecurityConfiguration创建。

1. 启动Gateway服务，检查日志是否消除ServerHttpSecurityConfiguration相关错误。
2. 访问/swagger-ui.html，确认OpenAPI文档可正常访问（无需授权）。
3. 携带有效JWT令牌访问受保护API，验证授权逻辑生效；未携带令牌时应返回401。

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