如何从 Spring Security 5.x 平滑升级到 6.1.x

梦瑶君_3588

梦瑶君_3588

2026-11-20

153人浏览

原创

如何从 Spring Security 5.x 平滑升级到 6.1.x

本文详解 Spring Security 5.x 到 6.1.x 的核心迁移要点,涵盖 authorizeRequests() 替换为 authorizeHttpRequests()、WebSecurityConfigurerAdapter 废弃后的配置重构、csrf()/cors() 等 DSL 更新语法,并提供可直接运行的配置示例与常见 403 错误排查方案。

本文详解 spring security 5.x 到 6.1.x 的核心迁移要点,涵盖 `authorizerequests()` 替换为 `authorizehttprequests()`、`websecurityconfigureradapter` 废弃后的配置重构、`csrf()`/`cors()` 等 dsl 更新语法,并提供可直接运行的配置示例与常见 403 错误排查方案。

Spring Security 6.1.x(基于 Spring Framework 6+)引入了全面重构的安全配置模型,彻底移除了长期被广泛使用的 WebSecurityConfigurerAdapter,并采用函数式、不可变的 SecurityFilterChain Bean 配置方式。若你仍沿用 Spring Security 5.x 的写法(如 http.authorizeRequests()),将导致编译失败或运行时 403 错误——这是因为旧方法已被标记为 @Deprecated 并在 6.0+ 中完全移除。

✅ 正确迁移步骤

1. 替换授权配置 DSL

authorizeRequests() → authorizeHttpRequests(),且必须使用 Lambda 表达式定义匹配规则:

@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
    http
        .authorizeHttpRequests(authz -> authz
            .requestMatchers("/", "/public/**").permitAll()  // ✅ 明确指定路径模式
            .anyRequest().authenticated()                     // ✅ 默认兜底策略(重要!)
        )
        .cors(Customizer.withDefaults())                      // ✅ 启用 CORS(需配合 CorsConfigurationSource)
        .csrf(AbstractHttpConfigurer::disable)                // ✅ 显式禁用 CSRF(注意:不再支持 .disable() 链式调用)
        .httpBasic(Customizer.withDefaults());                // ✅ 启用 HTTP Basic(可选)

    return http.build(); // ⚠️ 必须显式调用 build()
}

? 关键细节:

  • anyRequest().authenticated() 是必需的“兜底规则”,否则未显式匹配的请求将默认拒绝(返回 403)。
  • requestMatchers("/**") 虽可覆盖全部路径,但会绕过安全校验,仅适用于完全公开的 API;生产环境应遵循最小权限原则,分层配置。

2. 移除所有 @EnableWebSecurity 的过时用法

Spring Security 6+ 不再需要 @EnableWebSecurity 注解(它已隐式启用),但保留它不会报错;建议移除以保持代码简洁。

Gemini
Gemini

Gemini是一款由 Google 提供的个人 AI 助手和多模态生成式 AI 产品。

下载

3. CORS 配置需额外声明(如需跨域)

仅 .cors(Customizer.withDefaults()) 不足以生效,还需提供 CorsConfigurationSource Bean:

@Bean
CorsConfigurationSource corsConfigurationSource() {
    CorsConfiguration configuration = new CorsConfiguration();
    configuration.setAllowedOrigins(Arrays.asList("https://example.com", "http://localhost:3000"));
    configuration.setAllowedMethods(Arrays.asList("GET", "POST", "PUT", "DELETE", "OPTIONS"));
    configuration.setAllowCredentials(true);
    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
    source.registerCorsConfiguration("/**", configuration);
    return source;
}

4. 注意其他常见变更

  • antMatchers() / mvcMatchers() 已统一为 requestMatchers()(支持 AntPath、MvcPath、Regex 多种匹配器)。
  • formLogin()、logout() 等模块均改用 Customizer.withDefaults() 或函数式配置。
  • AuthenticationManager 需显式定义 Bean(若使用自定义认证逻辑),不再由框架自动创建。

⚠️ 常见陷阱与调试建议

  • 403 错误根源:未配置 anyRequest().authenticated() 或路径匹配顺序错误(如 "/api/**" 在 "/**" 之后将永不触发)。
  • CSRF 报错:若前端未携带 X-XSRF-TOKEN,又未禁用 CSRF,则 POST/PUT/DELETE 请求会失败;前后端需协同处理 Token 流程,或明确禁用(如 REST API 场景)。
  • 依赖版本对齐:确保 spring-boot-starter-security 与 Spring Boot 3.x(即 Spring Framework 6.x)版本严格匹配,避免混合引入 5.x 的 transitive 依赖。

完成上述调整后,你的安全配置即可兼容 Spring Security 6.1.x,并具备更好的类型安全性和可读性。建议同步查阅官方 Migration Guide 获取全量变更清单。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

spring security

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

3071

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

537

25

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

2026.11.20

0

8

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

60

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

80

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

20

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

80

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

40

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习