引入 spring-boot-starter-security 的第一天,所有接口突然全返回 401——这个「问候」逼每个初学者直奔主题:Security 到底在哪拦截的、怎么放行、怎么接管登录。答案是它的心脏:过滤器链(一串按序执行的 Servlet Filter 组成的安全流水线)。15.1 的 MVC 流水线之前,还有这条更早的安检门。
Security 的入口是 DelegatingFilterProxy(桥接 Servlet 容器与 Spring 的代理过滤器):Servlet 容器只认识它,它把请求转交给 Spring 容器里的 FilterChainProxy(安全过滤器链的总调度),后者按 SecurityFilterChain(一组安全过滤器的有序集合,可按 URL 模式配置多条)逐个放行过滤器。请求在到达 DispatcherServlet 之前,先被这条链从头到尾安检一遍。
链上的核心过滤器按顺序记五个:SecurityContextHolderFilter(从 Session 恢复/清理安全上下文——当前用户是谁存在 ThreadLocal 里)、UsernamePasswordAuthenticationFilter(拦截登录表单 POST,组装认证请求)、ExceptionTranslationFilter(把后面的认证授权异常翻译成 401/403 重定向)、AuthorizationFilter(末位裁判:按权限规则决定放行或拒)。一条链的哲学:前面的过滤器干活(认证),最后的过滤器裁决(授权),中间的翻译官兜异常。
认证的协作三件套:AuthenticationManager(认证总入口,遍历 Provider 找一个能处理该认证类型的)、AuthenticationProvider(具体认证逻辑的执行者——查库比对密码就发生在它委托的环节)、UserDetailsService(返回用户详情的加载接口——你写的主要就是它)。密码比对靠 PasswordEncoder(密码编码器,BCrypt 是标配——同密码每次哈希结果都不同,靠盐值内嵌,彩虹表无从下手)。
拿一次表单登录把三件套串起来走一遍时序:① 用户 POST /login,UsernamePasswordAuthenticationFilter 拦下,包成UsernamePasswordAuthenticationToken(未认证状态的认证请求对象);② 拦截器把它交给 AuthenticationManager,Manager 遍历 Provider,DaoAuthenticationProvider 认领(它专管用户名密码型);③ Provider 调用你的 UserDetailsService.loadByUsername 拿到库里的用户和密文;④ Provider 用 PasswordEncoder.matches 比对表单密码与密文——不匹配抛 BadCredentialsException,被 ExceptionTranslationFilter 翻译成 401 或跳回登录页;⑤ 匹配则把 Token 升级为已认证态(带上权限列表),存进 SecurityContext,Session 里记一笔。下次请求 SecurityContextHolderFilter 从 Session 恢复上下文——「登录过」的物理载体就是这个会话字段。时序在脑子里能放电影,任何变体题(验证码登录、短信登录、JSON 登录)都只是换第①步的拦截器和 Token 类型。
密码存储的演进也值得三十秒讲完,因为它是「安全史」的微缩:明文存储(库一拖密码全裸)→ MD5(能防拖库但防不住彩虹表:预算好的哈希对照表批量反查)→ MD5 加固定盐(盐一泄全盘重演)→ BCrypt(每次随机盐嵌进结果、可调成本因子的慢哈希——算一次故意花几十毫秒,暴力枚举每秒只能试几百次,算力攻击在经济上破产)。Boot 的 DelegatingPasswordEncoder 里密文带前缀 {bcrypt},框架按前缀路由到对应编码器——历史存量密码能逐个平滑升级,这也是「可演进设计」的好例子。
第一步放行,先把安检门对公开接口打开:
@Bean
SecurityFilterChain chain(HttpSecurity http) throws Exception {
http.authorizeHttpRequests(auth -> auth
.requestMatchers("/login", "/public/**").permitAll()
.anyRequest().authenticated())
.formLogin(Customizer.withDefaults());
return http.build();
}
第二步接管认证——实现 UserDetailsService,从自己的用户表加载:
@Bean
UserDetailsService uds(UserMapper mapper) {
return username -> {
User user = mapper.findByUsername(username); // 查库
if (user == null) throw new UsernameNotFoundException(username);
return org.springframework.security.core.userdetails.User
.withUsername(username)
.password(user.getPwdHash()) // BCrypt密文
.roles(user.getRole()) // 角色即权限
.build();
};
}
第三步授权精细化:hasRole("ADMIN")、hasAuthority("order:write") 按角色或权限点控制方法级访问;方法上用 @PreAuthorize("hasRole('ADMIN')")(方法安全:AOP 在方法调用前做权限校验的注解,13.3 的代理机制又一次上岗)做细粒度控制——URL 管粗门禁、注解管房间钥匙,两层各司其职。
hasRole 和 hasAuthority 的区别要咬准:底层都是比对权限字符串,但 hasRole("ADMIN") 会自动加 ROLE_ 前缀(实际匹配 ROLE_ADMIN),hasAuthority 匹配原样字符串——配套约定:UserDetailsService 里 .roles("ADMIN") 存成 ROLE_ADMIN,.authorities("order:write") 原样存。混用两套 API 是「权限明明配了就是拦我」的头号原因。方法安全还要求 @EnableMethodSecurity 显式开启(Boot 2 的老注解是 @EnableGlobalMethodSecurity),忘开则注解静默失效——和 13.3 事务注解失效是同一族排障题:先查代理有没有织上,再查表达式对不对。
登录成功后的自定义也几乎必被问到:formLogin(form -> form.successHandler(...).failureHandler(...)) 挂上两个处理器,返回 JSON(token、用户信息)代替默认 302 跳转——前后端分离的标准改法;logout 同理配 LogoutSuccessHandler 清理自定义状态。Security 的默认值面向传统服务端渲染应用,分离场景的定制点就集中在这些 Handler 上。
CSRF(跨站请求伪造:恶意网站借浏览器自动带的 Cookie 冒充用户发请求的攻击)默认开启——表单登录场景它用 token 防这一手,但前后端分离 + JWT(无 Cookie 依赖)场景它形同虚设还添乱,常规操作是 http.csrf(csrf -> csrf.disable())。要能说出为什么敢关:token 走 Header 不走 Cookie,CSRF 的借刀杀人(借 Cookie)就没了刀。同理 CORS 跨域在网关层统一配(16.4),链里不用重复。
Spring Security = DispatcherServlet 之前的一条安检流水线:过滤器链定顺序、Manager/Provider/DetailsService 定认证协作、AuthorizationFilter 定最终裁决——配好放行清单、接管 UserDetailsService、按场景裁剪 CSRF,三板斧就够应付八成项目。