Spring Boot 全局异常处理怎么捕获会话超时异常

风杰大大_7596

风杰大大_7596

2026-11-21

862人浏览

原创

spring boot 全局异常处理捕获会话超时异常,核心在于区分“请求被拦截”和“业务逻辑报错”。对于基于 cookie 的 session 机制,最稳妥的方式是配置 sessionregistry 或自定义 httpsessionlistener 结合前端轮询/拦截器,但针对 ajax 请求,推荐在 handlerexceptionresolver 中统一捕获由 spring security 或 tomcat 抛出的 invalidsessionexception 或 servletexception。具体做法是在全局异常处理器中判断异常类型,若为会话失效,则返回特定的 json 状态码(如 401)及提示信息,引导前端跳转登录页。

Spring Boot 全局异常处理怎么捕获会话超时异常

如何识别并拦截无效的 Session 请求

当用户会话过期时,Tomcat 容器或 Spring Security 会尝试访问已失效的 HttpSession,此时通常会抛出 IllegalStateException 或 InvalidSessionException。为了精准捕获这些异常,我们需要在全局异常处理器中专门处理这两类异常。通过检查异常堆栈或类型,我们可以确定当前请求是否因为会话丢失而失败,从而执行统一的错误响应逻辑,而不是让系统抛出默认的 500 错误或空白页面。

Spring Boot 全局异常处理怎么捕获会话超时异常

import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler({IllegalStateException.class, InvalidSessionException.class})
    public void handleSessionExpired(HttpServletRequest request, HttpServletResponse response,
                                     Exception ex) throws IOException {
        // 检查是否为 AJAX 请求
        String xhr = request.getHeader("X-Requested-With");
        if ("XMLHttpRequest".equals(xhr)) {
            response.setStatus(HttpServletResponse.SC_UNAUTHORIZED);
            response.setContentType("application/json;charset=UTF-8");
            response.getWriter().write(
                "{\"code\":401,\"message\":\"Session expired, please login again\"}"
            );
        } else {
            // 普通请求重定向到登录页
            response.sendRedirect(request.getContextPath() + "/login?expired=true");
        }
    }
}

上述代码展示了如何处理两种常见的会话异常。首先,它通过 @RestControllerAdvice 注册了全局异常处理器。接着,@ExceptionHandler 指定了要捕获的异常类型,包括 IllegalStateException(通常由 Tomcat 在访问无效 session 时抛出)和 InvalidSessionException(Spring Security 特有)。在处理逻辑中,代码检查了 X-Requested-With 请求头以区分 AJAX 和普通 HTTP 请求。如果是 AJAX 请求,直接写入 JSON 响应;否则,重定向到登录页面。这种处理方式确保了前后端分离场景下的用户体验一致性。

如何配置 Session 监听与清理策略

除了被动捕获异常,主动管理会话生命周期也是关键。可以通过实现 HttpSessionListener 接口来监听会话的创建与销毁事件。在 sessionDestroyed 方法中,可以执行清理操作,例如从内存中移除该用户的缓存数据或更新数据库中的在线状态。此外,结合 spring.session.store-type 配置,可以决定会话存储在后端还是 Redis 等外部存储中,这直接影响会话超时的检测机制。对于分布式系统,建议使用 Redis 存储会话,以便更灵活地控制超时时间和同步状态。

Spring Boot Actuator Analyzer
Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载

Spring Boot 全局异常处理怎么捕获会话超时异常

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.session.data.redis.config.annotation.web.http.EnableRedisHttpSession;
import org.springframework.session.web.http.SessionRepositoryFilter;

@Configuration
@EnableRedisHttpSession(maxInactiveIntervalInSeconds = 1800)
public class SessionConfig {

    @Bean
    public HttpSessionListener sessionListener() {
        return new HttpSessionListener() {
            @Override
            public void sessionCreated(HttpSessionEvent se) {
                System.out.println("Session created: " + se.getSession().getId());
            }

            @Override
            public void sessionDestroyed(HttpSessionEvent se) {
                System.out.println("Session destroyed: " + se.getSession().getId());
                // 在此处添加清理逻辑,如清除用户缓存
            }
        };
    }
}

这段代码演示了如何配置基于 Redis 的会话管理。通过 @EnableRedisHttpSession 注解,Spring Boot 会自动将会话数据存储到 Redis 中,并设置最大非活动间隔为 1800 秒(30分钟)。同时,定义了一个 HttpSessionListener Bean,用于监听会话的生命周期事件。当会话被创建或销毁时,控制台会打印相应日志。在实际应用中,可以在 sessionDestroyed 方法中添加业务逻辑,例如清除与该会话关联的用户缓存或更新在线用户列表。这种主动监听机制与被动异常捕获相结合,构成了完整的会话管理方案。

Session 超时后前端如何无感刷新 Token

在现代单页应用(SPA)中,完全依赖服务端 Session 可能导致用户体验不佳。一种常见做法是使用 JWT(JSON Web Token)进行认证,并将 Session 仅作为辅助验证手段。当 Session 超时时,前端可以通过拦截器捕获 401 状态码,然后尝试使用 Refresh Token 获取新的 Access Token。如果 Refresh Token 也失效,则强制用户重新登录。这种机制要求后端提供专门的 Token 刷新接口,并在 Session 配置中保持较长的有效期或采用滑动窗口策略。通过这种方式,即使用户长时间未操作,只要 Refresh Token 有效,即可实现无感续期,减少频繁登录带来的困扰。

相关文章

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

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

下载

相关标签:

spring boot 超时异常

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

相关专题

更多
spring boot框架优点
spring boot框架优点

spring boot框架的优点有简化配置、快速开发、内嵌服务器、微服务支持、自动化测试和生态系统支持。本专题为大家提供spring boot相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.05

751

5

spring框架有哪些
spring框架有哪些

spring框架有Spring Core、Spring MVC、Spring Data、Spring Security、Spring AOP和Spring Boot。详细介绍:1、Spring Core,通过将对象的创建和依赖关系的管理交给容器来实现,从而降低了组件之间的耦合度;2、Spring MVC,提供基于模型-视图-控制器的架构,用于开发灵活和可扩展的Web应用程序等。

2023.10.12

1475

7

Java Spring Boot开发
Java Spring Boot开发

本专题围绕 Java 主流开发框架 Spring Boot 展开,系统讲解依赖注入、配置管理、数据访问、RESTful API、微服务架构与安全认证等核心知识,并通过电商平台、博客系统与企业管理系统等项目实战,帮助学员掌握使用 Spring Boot 快速开发高效、稳定的企业级应用。

2025.08.19

6046

10

Java Spring Boot 4更新教程_Java Spring Boot 4有哪些新特性
Java Spring Boot 4更新教程_Java Spring Boot 4有哪些新特性

Spring Boot 是一个基于 Spring 框架的 Java 开发框架,它通过 约定优于配置的原则,大幅简化了 Spring 应用的初始搭建、配置和开发过程,让开发者可以快速构建独立的、生产级别的 Spring 应用,无需繁琐的样板配置,通常集成嵌入式服务器(如 Tomcat),提供“开箱即用”的体验,是构建微服务和 Web 应用的流行工具。

2025.12.22

456

5

Java Spring Boot 微服务实战
Java Spring Boot 微服务实战

本专题深入讲解 Java Spring Boot 在微服务架构中的应用,内容涵盖服务注册与发现、REST API开发、配置中心、负载均衡、熔断与限流、日志与监控。通过实际项目案例(如电商订单系统),帮助开发者掌握 从单体应用迁移到高可用微服务系统的完整流程与实战能力。

2025.12.24

680

18

Spring Boot企业级开发与MyBatis Plus实战
Spring Boot企业级开发与MyBatis Plus实战

本专题面向 Java 后端开发者,系统讲解如何基于 Spring Boot 与 MyBatis Plus 构建高效、规范的企业级应用。内容涵盖项目架构设计、数据访问层封装、通用 CRUD 实现、分页与条件查询、代码生成器以及常见性能优化方案。通过完整实战案例,帮助开发者提升后端开发效率,减少重复代码,快速交付稳定可维护的业务系统。

2026.02.11

425

24

Kotlin协程编程与Spring Boot集成实践
Kotlin协程编程与Spring Boot集成实践

本专题围绕 Kotlin 协程机制展开,深入讲解挂起函数、协程作用域、结构化并发与异常处理机制,并结合 Spring Boot 展示协程在后端开发中的实际应用。内容涵盖异步接口设计、数据库调用优化、线程资源管理以及性能调优策略,帮助开发者构建更加简洁高效的 Kotlin 后端服务架构。

2026.02.12

411

18

Spring Boot 项目开发与实战
Spring Boot 项目开发与实战

以 Spring Boot 为核心,讲解项目的快速初始化(Spring Initializr)、自动配置与 Starter 依赖原理、配置文件(application.yml)多环境管理、RESTful API 接口开发与参数校验、MyBatis / MyBatis-Plus / Spring Data JPA 数据持久层整合、Redis 缓存集成、统一异常处理与全局响应封装、Swagger / Knife4j 接口文档生成,以及 Ma

2026.04.17

386

21

Java Spring Boot多租户架构设计与数据隔离实战
Java Spring Boot多租户架构设计与数据隔离实战

本专题聚焦 Java 企业级系统中的多租户架构设计,讲解数据隔离策略、租户路由机制、数据库分库分表方案以及权限控制模型。通过真实 SaaS 系统案例,帮助开发者构建可扩展的多租户应用架构。

2026.06.29

636

13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Spring Boot 官方快速入门指南
Spring Boot 官方快速入门指南

共0课时 | 0人学习

Spring Boot 官方参考文档
Spring Boot 官方参考文档

共0课时 | 0人学习

尚硅谷新版SpringBoot3教程
尚硅谷新版SpringBoot3教程

共0课时 | 0人学习