spring boot 全局异常处理可以通过配置 @controlleradvice 结合 handlerexceptionresolver 或自定义 handlerinterceptor 来捕获会话过期异常。核心做法是拦截请求,检查 session 中是否存在关键用户标识(如 userid),若缺失则抛出特定异常(如 sessionexpiredexception),并在全局异常处理器中统一返回 json 错误响应或重定向到登录页。

HandlerInterceptor 如何检测 Session 失效
通过实现 HandlerInterceptor 接口,在 preHandle 方法中检查 HttpSession 的有效性。如果 Session 不存在或其中没有预期的用户数据,直接返回 false 并设置响应状态码为 401 或 302,从而阻止请求进入 Controller。

import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.springframework.stereotype.Component; import org.springframework.web.servlet.HandlerInterceptor; @Component public class SessionInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session = request.getSession(false); if (session == null || session.getAttribute("userId") == null) { response.setStatus(HttpServletResponse.SC_UNAUTHORIZED); response.setContentType("application/json;charset=UTF-8"); response.getWriter().write("{\"error\":\"Session expired\"}"); return false; } return true; }}
@ControllerAdvice 如何统一处理业务异常
当使用自定义异常类时,可以通过 @RestControllerAdvice 捕获这些异常并转换为标准的 HTTP 响应。这种方式适用于那些在 Service 层或 Interceptor 中主动抛出的业务逻辑异常,确保前端能接收到结构化的错误信息。

import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RestControllerAdvice; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; import java.util.HashMap; import java.util.Map; @RestControllerAdvice public class GlobalExceptionHandler { @ExceptionHandler(SessionExpiredException.class) public ResponseEntity<Map<String, String>> handleSessionExpired(SessionExpiredException ex) { Map<String, String> error = new HashMap<>(); error.put("error", "Session expired"); error.put("message", ex.getMessage()); return new ResponseEntity<>(error, HttpStatus.UNAUTHORIZED); } }Session 超时时间对异常捕获的影响
Session 的超时时间(如 server.servlet.session.timeout=30m)决定了会话多久后自动失效。如果超时时间设置过短,可能导致用户在操作过程中频繁遇到会话过期异常。在实际开发中,应根据业务需求调整超时时间,并结合前端心跳机制或 Token 刷新策略来优化用户体验。


















