对于最新的稳定版本，请使用 Spring Security 6.4.1！spring-doc.cn

配置迁移

以下步骤与有关如何配置和相关组件的更改相关。HttpSecurityWebSecurityspring-doc.cn

使用 Lambda DSL

Lambda DSL 自 5.2 版起存在于 Spring Security 中，它允许使用 Lambda 配置 HTTP 安全性。spring-doc.cn

您可能已经在 Spring Security 文档或示例中看到了这种风格的配置。让我们看一下 HTTP 安全性的 lambda 配置与之前的配置样式的比较。spring-doc.cn

使用 lambda 的配置

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests(authorize -> authorize
                .requestMatchers("/blog/**").permitAll()
                .anyRequest().authenticated()
            )
            .formLogin(formLogin -> formLogin
                .loginPage("/login")
                .permitAll()
            )
            .rememberMe(Customizer.withDefaults());

        return http.build();
    }
}

不使用 lambda 的等效配置

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests()
                .requestMatchers("/blog/**").permitAll()
                .anyRequest().authenticated()
                .and()
            .formLogin()
                .loginPage("/login")
                .permitAll()
                .and()
            .rememberMe();

        return http.build();
    }
}

Lambda DSL 是配置 Spring Security 的首选方式，之前的配置样式在需要使用 Lambda DSL 的 Spring Security 7 中无效。这样做主要有几个原因：spring-doc.cn

以前的方法在不知道返回类型是什么的情况下不清楚要配置什么对象。嵌套越深，它就越令人困惑。即使是有经验的用户也会认为他们的配置在做一件事，而实际上，它正在做其他事情。spring-doc.cn
一致性。许多代码库在两种样式之间切换，这会导致不一致，从而难以理解配置，并经常导致配置错误。spring-doc.cn

Lambda DSL 配置提示

在比较上述两个示例时，您会注意到一些关键差异：spring-doc.cn

在 Lambda DSL 中，无需使用该方法链接配置选项。调用 lambda 方法后，将自动返回实例以供进一步配置。.and()HttpSecurityspring-doc.cn
Customizer.withDefaults()使用 Spring Security 提供的默认值启用安全功能。这是 lambda 表达式的快捷方式。it → {}spring-doc.cn

WebFlux 安全性

您也可以以类似的方式使用 lambda 配置 WebFlux 安全性。以下是使用 Lambda 的示例配置。spring-doc.cn

使用 lambda 的 WebFlux 配置

@Configuration
@EnableWebFluxSecurity
public class SecurityConfig {

    @Bean
    public SecurityWebFilterChain springSecurityFilterChain(ServerHttpSecurity http) {
        http
            .authorizeExchange(exchanges -> exchanges
                .pathMatchers("/blog/**").permitAll()
                .anyExchange().authenticated()
            )
            .httpBasic(Customizer.withDefaults())
            .formLogin(formLogin -> formLogin
                .loginPage("/login")
            );

        return http.build();
    }

}

Lambda DSL 的目标

创建 Lambda DSL 是为了实现以下目标：spring-doc.cn

自动缩进使配置更具可读性。spring-doc.cn
无需使用.and()spring-doc.cn
Spring Security DSL 具有与其他 Spring DSL （如 Spring Integration和 Spring Cloud Gateway）类似的配置样式。spring-doc.cn

用于自定义 DSL`.with().apply()`

在 6.2 之前的版本中，如果您有自定义 DSL，则可以将其应用于使用该方法。但是，从版本 6.2 开始，此方法已被弃用，并将在 7.0 中删除，因为将无法再使用一次删除来链接配置（请参阅 github.com/spring-projects/spring-security/issues/13067）。相反，建议使用新方法。有关如何使用的更多信息，请参阅自定义 DSLs 部分。HttpSecurityHttpSecurity#apply(…).and().and().with(…).with(…)spring-doc.cn