Spring MVC 中可通过 RequestContextHolder 在 Service 或工具类中安全获取 HttpSession，但需 RequestContextFilter 已启用且当前线程处理 Web 请求；否则会抛 IllegalStateException。
Spring MVC 中可以通过 RequestContextHolder 在非控制器层（如 Service、Util 工具类）中安全获取当前请求的 HttpSession，但需满足前提：当前线程正处理一个 Web 请求，且 Spring 的 RequestContextFilter（或 RequestContextListener）已正确配置。
确保请求上下文可用
Spring 默认不会自动将请求绑定到当前线程，必须显式启用。否则 RequestContextHolder.currentRequestAttributes() 会抛出 IllegalStateException。
- 在基于 Servlet 3.0+ 的应用中，推荐使用
RequestContextFilter，在web.xml中配置（或通过@Configuration注册为 Bean）：
<filter> <filter-name>requestContextFilter</filter-name> <filter-class>org.springframework.web.filter.RequestContextFilter</filter-class> </filter> <filter-mapping> <filter-name>requestContextFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>
- 若用 Spring Boot，默认已自动注册
RequestContextFilter（只要没禁用），无需额外配置；可通过@ConditionalOnMissingBean(RequestContextFilter.class)确认。
从 RequestContextHolder 获取 HttpSession
在 Service 或工具类中，不依赖注入 HttpServletRequest，直接通过静态方式获取：
- 先获取当前请求属性（
RequestAttributes），再从中提取HttpSession：
RequestAttributes requestAttrs = RequestContextHolder.getRequestAttributes();
if (requestAttrs instanceof ServletRequestAttributes) {
HttpServletRequest request = ((ServletRequestAttributes) requestAttrs).getRequest();
HttpSession session = request.getSession(false); // false 表示不自动创建
if (session != null) {
Object userId = session.getAttribute("userId");
// 使用 session 数据...
}
}
-
getSession(false)更安全，避免无意义创建新 session；如需确保存在，可改用getSession(true)。 - 务必判空
requestAttrs和session，因为异步线程、定时任务等场景下上下文为空。
封装成工具方法提升复用性
避免重复判空和类型转换，建议封装为静态工具方法：
立即学习“Java免费学习笔记（深入）”；
public class WebUtils {
public static HttpSession getCurrentSession() {
RequestAttributes attrs = RequestContextHolder.getRequestAttributes();
if (attrs instanceof ServletRequestAttributes) {
HttpServletRequest request = ((ServletRequestAttributes) attrs).getRequest();
return request.getSession(false);
}
return null;
}
public static <T> T getSessionAttr(String name, Class<T> type) {
HttpSession session = getCurrentSession();
if (session != null) {
Object val = session.getAttribute(name);
if (type.isInstance(val)) {
return type.cast(val);
}
}
return null;
}
}
- 调用示例：
Long userId = WebUtils.getSessionAttr("userId", Long.class); - 该方法天然兼容 Spring Boot 和传统 XML 配置项目。
注意线程与异步场景限制
RequestContextHolder 依赖 ThreadLocal，只对当前请求线程有效：
- 若在
@Async方法、线程池（如Executors.newFixedThreadPool）、定时任务（@Scheduled）中调用，将无法获取 session —— 此时请求上下文已脱离原线程。 - 如确需跨线程传递 session 数据，应在主线程中提前取出必要信息（如用户 ID、权限标识），作为参数显式传入异步方法。
- 不推荐手动调用
RequestContextHolder.setRequestAttributes(...)跨线程传递，易引发内存泄漏或并发问题。
