一个开发者对 Spring Security 拦截机制的深度追问(续)

Spring Security 5.x 实战:轻松搞定 WebSocket 连接被拦截的坑(附完整配置代码) 本文深入解析了Spring Security 5.x中WebSocket连接被拦截的常见问题,提供了详细的解决方案和完整配置代码。通过正确使用WebSecurity.ignoring()方法,开发者可以轻松绕过安全过滤器,确保WebSocket握手请求不被拦截,同时保持应用的安全性。文章还涵盖了生产级配置示例、高级场景处理及性能优化建议。 阅读详情

作者:旷野说
关键词:Spring Security、Servlet Filter、403 异常、安全架构、过滤器链、口诀记忆

🕵️‍♂️ 三、“静默 403”不是玄学,而是可解的谜题

为搞明白 ExceptionTranslationFilter 的“温柔一刀”——它把所有安全异常都悄悄吞掉,换成一个干净的 403 响应。
对用户友好,对开发者“不友好”。

但好消息是:这个问题完全可解。下面是我总结的四步调试法,从“看到异常”到“精准定位”,再到“生产友好响应”,一气呵成。


✅ 第一步:先开 DEBUG 日志——让安全决策“说话”

这是成本最低、见效最快的方式。只需在 application.yml 中加一行:

logging:
  level:
    org.springframework.security: DEBUG

开启后,你会看到类似这样的日志:

DEBUG o.s.s.w.a.i.FilterSecurityInterceptor - 
  Secure object: FilterInvocation: URL: /api/v1/orders/create
  Attributes: [authenticated]

DEBUG o.s.s.w.a.i.FilterSecurityInterceptor - 
  Previously Authenticated: User [name=admin, roles=[USER, ADMIN]]

DEBUG o.s.s.access.vote.AffirmativeBased - 
  Voter: WebExpressionVoter, returned: -1  👈 权限投票失败!

AccessDeniedException: Access is denied

💡 关键信息:

  • 请求的 URL 是什么?
  • 当前用户是谁?
  • 权限校验在哪一步失败?
  • 是 FilterSecurityInterceptor(URL 层)还是 MethodSecurityInterceptor(方法层)抛出的?

✅ 这是日常开发的首选手段——无侵入、开箱即用。


✅ 第二步:自定义异常处理器——让 403 “会说话”

DEBUG 日志适合后台看,但前端也需要知道为什么被拒。
于是,我实现了两个处理器:

1. CustomAccessDeniedHandler(处理 403)
@Component
public class CustomAccessDeniedHandler implements AccessDeniedHandler {
    private static final Logger log = LoggerFactory.getLogger(CustomAccessDeniedHandler.class);

    @Override
    public void handle(HttpServletRequest req, HttpServletResponse res, AccessDeniedException e) throws IOException {
        String uri = req.getRequestURI();
        Authentication auth = SecurityContextHolder.getContext().getAuthentication();
        String user = auth != null ? auth.getName() : "anonymous";

        // 📝 记录完整上下文,便于排查
        log.warn("ACCESS DENIED | URI: {} | User: {} | Cause: {}", uri, user, e.getMessage());

        // 💬 返回结构化错误,前端可友好提示
        res.setStatus(403);
        res.setContentType("application/json;charset=UTF-8");
        res.getWriter().write("""
            {
              "code": 403,
              "message": "权限不足",
              "detail": "当前用户无权访问此资源",
              "timestamp": "%s"
            }
            """.formatted(Instant.now()));
    }
}
2. CustomAuthenticationEntryPoint(处理 401)
@Component
public class CustomAuthenticationEntryPoint implements AuthenticationEntryPoint {
    @Override
    public void commence(HttpServletRequest req, HttpServletResponse res, AuthenticationException ex) throws IOException {
        log.warn("UNAUTHENTICATED | URI: {} | Error: {}", req.getRequestURI(), ex.getMessage());
        res.setStatus(401);
        res.getWriter().write("""
            {"code":401,"message":"请先登录","detail":"Token missing or invalid"}
            """);
    }
}
3. 在 SecurityConfig 中注册:
@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
    http
        .exceptionHandling(e -> e
            .accessDeniedHandler(customAccessDeniedHandler)
            .authenticationEntryPoint(customAuthenticationEntryPoint)
        )
        .csrf().disable()
        .authorizeHttpRequests(authz -> authz
            .requestMatchers("/login").permitAll()
            .anyRequest().authenticated()
        )
        .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS)
        .addFilterBefore(jwtAuthenticationFilter, UsernamePasswordAuthenticationFilter.class);

    return http.build();
}

✅ 效果:

  • 前端收到 带错误码和提示的 JSON,不再一脸懵;
  • 后台日志留下 完整上下文,支持快速排查。

✅ 第三步:开发环境临时“放行异常”——看原始堆栈

有时候,连日志都不够用。我想直接看到异常堆栈!

于是,我在开发环境加了一个开关:

@Value("${app.security.debug:false}")
private boolean securityDebug;

@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
    // ... 其他配置

    // 🔧 仅在生产关闭异常转换,开发环境直接抛异常!
    if (!securityDebug) {
        http.exceptionHandling(e -> e
            .accessDeniedHandler(accessDeniedHandler)
            .authenticationEntryPoint(authenticationEntryPoint)
        );
    }

    return http.build();
}

启动时开启:

# application-dev.yml
app:
  security:
    debug: true

✅ 效果:
直接看到 AccessDeniedException 完整堆栈,一眼看出是 Web 层还是方法层拦截。

⚠️ 注意:此模式仅用于本地开发,切勿上线!


✅ 第四步:快速判断拦截层级——是 Filter 还是 AOP?

这是我总结的快速诊断表:

判断依据Filter 拦截(URL 权限)AOP 拦截(方法权限)
Controller 是否执行?❌ 不执行✅ 执行
Service 方法是否进?❌ 不进❌ 不进(但在 Controller 之后被拦)
日志关键词FilterInvocation: URL: /xxxMethod: public void ...
调试技巧Controller 第一行加日志 → 没输出Controller 日志有输出,Service 没进 → 方法级拦截

💡 口诀:
“403 无日志?查 Filter;进了 Controller 还 403?查 @PreAuthorize!”


🧠 终极口诀:调试 403 的黄金五步法

一开日志看过程,
二写 Handler 记上下文,
三用开关看堆栈,
四判层级分 Filter 与 AOP,
五记口诀不迷路!


通过这套组合拳,我终于把“神秘 403”变成了可追踪、可解释、可修复的普通 bug。
Spring Security 不再是黑盒,而是一条透明、可控的安全流水线。

安全,本该如此清晰。 🔐

Apache Shiro CVE-2020-1957漏洞深度剖析:从路径匹配原理到实战修复 在Java Web应用安全领域,权限控制是保障系统安全的核心机制之一,其原理在于对用户请求的访问路径进行匹配与校验。Apache Shiro作为广泛使用的安全框架,通过Ant风格路径匹配器实现URL级别的访问控制。然而,路径匹配逻辑与后端Web容器路径解析的不一致,可能引发严重的安全漏洞。CVE-2020-1957正是此类问题的典型代表,其技术价值在于揭示了权限校验层与业务执行层在路径标准化处理上的差异风险。该漏洞允许攻击者通过构造包含特殊字符(如分号)的请求,绕过Shiro的权限校验,直接访问受保护的资源 阅读详情

相关推荐

若依代码生成器 3.9.2 字段权限配置详解:4种操作权限与前端按钮联动实战

本文详细解析了若依代码生成器3.9.2版本的字段权限配置,涵盖从数据库注释到前端按钮联动的完整流程。通过RBAC模型实现4种操作权限(新增、查询、更新、删除)的精细化控制,结合前后端分离架构,为开发者提供高效的企业级权限管理解决方案。

weixin_34375251的博客 394

IP: thread:http-nio-8080-exec-1 USER: message:An internal error occurred while t解决方案

【代码】IP: thread:http-nio-8080-exec-1 USER: message:An internal error occurred while t解决方案。

m0_65065082的博客 2211

芋道前后端分离项目免登录配置实战:Nacos与YML详解

本文详细解析了在芋道前后端分离项目中配置免登录功能的完整流程。通过剖析请求拦截原理,分别讲解了如何在Nacos配置中心或本地YML文件中设置后端安全规则,以及如何在前端路由守卫中添加白名单。文章结合实战经验,提供了前后端联调的深度避坑指南,帮助开发者高效、安全地实现特定页面与接口的公开访问。

weixin_27945229的博客 127

SpringSecurity权限控制实战:为什么你的permitAll配置不生效?

本文深入解析SpringSecurity权限控制中permitAll配置失效的常见问题,特别是当请求携带有效Token时触发AccessDeniedException的情况。通过源码分析和实战案例,揭示多层过滤机制与权限评估逻辑的冲突根源,并提供多种解决方案与调试技巧,帮助开发者高效解决权限控制难题。

rainy的博客 683

Apache Shiro CVE-2020-1957漏洞剖析:路径遍历攻击与权限绕过实战

路径遍历攻击是Web安全领域的经典威胁,其核心原理在于利用系统对路径解析的差异,绕过预设的访问控制。在Java Web开发中,安全框架如Apache Shiro通过过滤器链和Ant风格路径匹配机制,为应用提供身份认证与授权能力。然而,当框架的路径匹配逻辑与后端控制器(如Spring MVC)的路径解析行为不一致时,便可能产生上下文相关的安全漏洞,导致权限校验失效。CVE-2020-1957正是这样一个典型案例,攻击者通过构造包含分号路径参数和目录遍历序列的特殊URL,利用Shiro过滤器与Spring MV

weixin_34007886的博客 277

ACM算法模板 · 一些常用的算法模板-模板合集(打比赛专用)

萌新常用的都在这了,本萌新的模板集。

张天枭の博客 5万+

一个开发者对 Spring Security 拦截机制的深度追问

摘要:Spring Security 403异常解析 本文通过作者解决一个403访问拒绝问题的经历,深入剖析了Spring Security的安全机制。当/api/v1/orders/create接口返回403但未进入Controller时,作者发现请求被Spring Security在Servlet Filter层提前拦截。关键发现包括:1) Spring Security通过FilterChainProxy封装安全过滤器链;2) URL权限(authorizeHttpRequests)和方法权限(@Pr

Talbot3的笔记 1378

从零开始掌握Python机器学习:七步教程 基础篇

前言 「开始」往往是最难的,尤其是当选择太多的时候,一个人往往很难下定决定做出选择。本教程的目的是帮助几乎没有 Python 机器学习背景的新手成长为知识渊博的实践者,而且这个过程中仅需要使用免费的材料和资源即可。 第一步:基本 Python 技能 如果我们打算利用 Python 来执行机器学习,那么对 Python 有一些基本的了解就是至关重要的。 首先,你需要安装 Python。因为我们后...

hcgx2018的博客 1617

Swagger3 与 Spring Security 5.7 权限冲突:4步排查与路径放行配置指南

本文详细解析了Swagger3与Spring Security 5.7集成时常见的权限冲突问题,包括'Unable to infer base url'等典型错误。通过4步排查法和路径放行配置指南,帮助开发者快速解决Swagger资源被拦截的问题,确保API文档正常访问。

weixin_30715523的博客 348

STM32 FOC半周期控制延时分析与硬件同步配置

在电机矢量控制(FOC)系统中,数字控制延时是影响电流环带宽、观测器收敛性与系统稳定性的核心瓶颈。其本质源于PWM更新、ADC采样与计算执行之间的时序错配,典型表现为1.5个PWM周期的相位滞后,导致滑模观测器(SMO)失效或高速振荡。通过零阶保持(ZOH)建模可量化该延时对系统相频特性的影响,并揭示其等效为0.5u(t)+0.5u(t−1)的平滑控制律。工程上突破的关键在于重构外设协同机制——以高级定时器重复计数器(RCR0)驱动中心对齐PWM的半周期更新事件,使控制量在0.5T_PWM内生效,同步触发多

flink9streamer的博客 1132

STM32F407串口DMA收发实战:标准库配置与环形缓冲区实现

DMA(直接存储器访问)是嵌入式系统中提升数据传输效率的核心技术,它允许外设与内存直接交换数据而无需CPU干预。其工作原理是通过专用硬件控制器接管数据搬运任务,CPU仅需初始化传输参数即可处理其他事务,从而显著降低系统负载。这项技术的核心价值在于释放CPU算力,实现高吞吐、低延迟的实时通信,尤其适用于数据采集、工业控制和通信网关等场景。在STM32F407等ARM Cortex-M4芯片中,串口结合DMA可实现稳定的高速数据流处理。本文以STM32F407标准库为基础,深入解析USART1的DMA发送与接收

weixin_29169899的博客 323

Spring Boot脚手架集成 Spring Security实现生产级RBAC鉴权

本文详细介绍了如何在Spring Boot 3项目中实现企业级RBAC权限管理系统。主要内容包括: 架构对比:C端JWT拦截器与B端Spring Security鉴权的差异 RBAC标准表结构设计(用户、角色、权限等7张表) 核心实现流程: 引入Spring Security依赖 自定义UserDetails实现类(CustomUserDetails) 登录时缓存权限数据到Redis 实现Token认证过滤器 权限校验流程图示(通过Mermaid展示完整鉴权过程) 该项目采用Spring Security

RemainderTime 326

7.1华为OD机试真题 新系统 - 奇偶三数之和 (Java/Py/C/C++/Js/Go)

7.1华为OD机试真题 新系统 - 奇偶三数之和 (Java/Py/C/C++/Js/Go)

算法大师! 452

Spring Boot会话固定攻击防御:原理剖析与实战配置指南

会话管理是Web应用安全的核心基础,它通过在服务器端创建唯一标识来跟踪用户状态。其原理基于HTTP无状态协议,通过Cookie或URL参数传递会话ID,实现用户身份持续认证。在安全领域,会话固定攻击是一种常见威胁,攻击者通过预置会话ID,诱骗受害者使用该ID登录,从而窃取身份。这种攻击对金融、电商等高敏感系统危害极大。本文聚焦Spring Boot框架,深入解析会话固定攻击链,并基于最佳工程实践,提供从Spring Security配置、Cookie安全加固到客户端指纹绑定的多层次防御方案,确保系统会话安全

cuk0051的博客 377

SCADA|KingSCADA实现有新报警时声音报警提示

在SCADA项目中有的现场系统比较多,每个调度员可能会一个人盯好多个系统,因此不会一直盯着一个系统,这时候就需要当有新的报警产生时,有报警声音提示,提示调度员查看报警,进行处理。$NewAlarm是一个离散型的变量,是新报警的意思,即当前系统中有新的报警信息产生时,该变量会自动置为1;以上为一最简单的报警提示的实现,实际中可能还会要求语音播报啥啥报警的声音,具体有时间再进行测试。通过创建测试界面,创建一个内存变量,内存变量,配置报警,界面按钮制造报警,测试效果。

做有价值的事,积累有价值的笔记! 1409

R语言Rstudio突然无法启动且报错:ERROR system error 42 [str: 一, len: 3, from: UTF-8, to: ISO8859-1]...如何解决

🏆本文收录于 《全栈 Bug 调优(实战版)》 专栏。专栏聚焦真实项目中的各类疑难 Bug,从成因剖析 → 排查路径 → 解决方案 → 预防优化全链路拆解,形成一套可复用、可沉淀的实战知识体系。无论你是初入职场的开发者,还是负责复杂项目的资深工程师,都可以在这里构建一套属于自己的「问题诊断与性能调优」方法论,助你稳步进阶、放大技术价值 。

**My Coding Family** 2850

若依(RuoYi)权限管理深度解析:如何基于RBAC模型定制你的企业级权限系统

本文深度解析若依(RuoYi)框架基于RBAC模型的权限管理系统,涵盖从基础架构到企业级数据隔离的实战定制。详细介绍了权限分层设计、数据权限的四种模式、性能优化策略以及多租户与混合权限模型等高级定制方案,帮助企业构建灵活、安全且高效的权限控制体系。

pytorch8learner的博客 171

反卷积通俗详细解析与nn.ConvTranspose2d重要参数解释

反卷积的作用 卷积中padding的几个概念 No Padding Half(Same) Padding Full Padding 反卷积 反卷积中的Padding参数 反卷积的stride参数 反卷积总结 参考资料

iioSnail的博客 2万+

#从401到200:Spring Boot + Vue 静态资源访问全链路问题解决方案

静态资源访问问题的核心是“路径一致性”和“权限全链路放行后端需确保资源映射、Security放行、拦截器排除、XSS过滤的四层协同;前端需规范打包路径和资源引用方式,避免Token误携带。通过本文的全链路配置,可彻底解决Spring Boot + Vue架构下的静态资源401/404问题,同时保障系统安全性和可扩展性。实际项目中,建议结合自身目录结构和权限需求,灵活调整配置细节,优先采用“目录结构扁平化”“路径规范化”的设计原则,从根源减少类似问题的发生。

zbt898241895的博客 928

廖雪峰Python教程[完整版]

廖雪峰的python教程整理的,已经排好版了,而且还是完整的,适合小白

LinePhone3.2.7(android端最新版本) sip客户端

SIP客户端For android:LinePhone3.2.7(最新版本),官网地址:http://www.linphone.org/

基于Spring Boot的园林植物信息管理系统毕设全解析

在Java后端开发中,Spring Boot凭借自动配置与快速构建能力,成为企业级应用与课程设计的主流框架。理解其分层架构与数据访问原理,是掌握Web系统开发的关键。以管理系统为例,围绕业务数据的增删改查、权限控制与页面交互,能够完整串联Controller、Service、Mapper三层职责。此类系统广泛应用于信息管理场景,如园林植物信息管理,结合MyBatis-Plus简化数据持久层开发,配合MySQL存储结构化数据,即可实现一个技术栈主流、结构完整的毕设项目。从选题价值到数据库设计,从核心代码到部署

weixin_33937778的博客 486

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

SpringSecurity 静态资源放行深度详解(解决401认证失败、文件无法访问、URL拦截问题)

后端生成 Excel 文件存放在服务器临时目录,通过资源映射配置访问路径:/excel/**,前端、APP 通过 URL 直接下载文件。Security 不会识别这是静态文件,只会识别请求路径 /excel/,该路径未配置放行,因此判定为需要登录认证,最终返回 401。/excel/** 匹配规则:以 /excel/ 开头的所有子路径,包含所有Excel文件。映射路径:/file/**,放行路径写:/excel/**,路径不统一,依旧拦截。

boyVyYVf7的博客 153

文档:亲测可用解决vnc灰屏,黑屏,鼠标大黑叉情况

主要解决vnc-viewer灰屏,黑屏,鼠标大黑叉等现象,详细见文档。

Spring AOP核心原理与实践:从代理机制到高级应用场景

面向切面编程(AOP)是一种重要的编程范式,它通过将横切关注点(如日志、事务、安全等)从核心业务逻辑中分离出来,实现代码的模块化和解耦。其核心原理基于代理模式,在程序运行时动态地将额外逻辑织入到目标方法中,从而在不修改原有代码的情况下增强功能。这一技术为软件工程带来了显著价值,包括提升代码复用性、降低耦合度、增强可维护性。在实际应用中,AOP广泛用于日志记录、事务管理、权限控制、性能监控等通用场景。本文以Spring AOP为例,深入剖析其核心概念与实现机制,特别是JDK动态代理与CGLIB代理的差异与选择

weixin_30784501的博客 311

Ruoyi+Vue项目实战:如何优雅处理文件上传的Token认证问题

本文深入解析了在Ruoyi+Vue项目中,使用el-upload组件进行文件上传时常见的Token认证失败问题。通过剖析axios请求拦截器与el-upload默认行为的差异,提供了自定义http-request方法、改造请求拦截器以及封装全局上传组件等多种优雅的解决方案,确保文件上传请求能正确携带认证Token。

t1u2v的博客 477

Chrome ERR_FAILED错误排查指南:从网络诊断到本地开发环境修复

网络请求失败是前端开发和日常浏览中的常见问题,其背后涉及浏览器网络栈、安全策略和系统环境等多层原理。理解网络请求的生命周期,从DNS解析、TCP连接到SSL握手,有助于定位故障环节。在工程实践中,这类问题不仅影响用户体验,更直接关系到开发调试效率和系统安全性。特别是在本地开发场景中,HTTPS证书校验、CORS跨域策略以及浏览器安全升级(如私有网络请求阻塞)成为高频诱因。本文聚焦Chrome浏览器的ERR_FAILED错误,通过系统性排查框架,覆盖网络环境检查、浏览器内部清理、开发者工具深度诊断及安全策略适

aizexi2652的博客 347
上一篇: 一个开发者对 Spring Security 拦截机制的深度追问
下一篇: SSO、账号密码和短信验证码我都要-Spring Security 的认证多源登录简记
旷野说
博客等级 码龄9年 361粉丝 86原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值