Java优学网SpringMVC拦截器教程：轻松掌握请求拦截与权限控制，提升开发效率

1.1 拦截器的基本概念与作用

想象一下你进入一栋办公大楼。在到达目标办公室之前，通常会经过前台登记、安全检查、门禁刷卡这些环节。SpringMVC拦截器就扮演着类似的角色——它们是请求到达控制器之前的“关卡”。

拦截器本质上是一种面向切面编程的实现。当客户端发起请求时，拦截器能够在请求到达Controller之前、Controller处理之后、以及请求完成之后这三个关键时间点插入自定义逻辑。这种机制让开发者能够在不影响核心业务代码的前提下，为系统添加各种横切关注点功能。

我记得在开发一个电商项目时，我们使用拦截器来处理用户会话验证。每次用户访问需要登录的页面，拦截器都会自动检查登录状态，避免了在每个Controller方法中重复编写相同的验证代码。这种设计让代码维护变得轻松许多。

1.2 拦截器与过滤器的区别

很多初学者会混淆拦截器和过滤器的概念。虽然它们都用于预处理请求，但工作层次和功能范围有着本质区别。

过滤器是Servlet规范的一部分，工作在更底层的Web容器级别。它能过滤所有请求，包括静态资源。而拦截器是SpringMVC框架的组成部分，只对进入SpringMVC控制器的请求生效。

从功能角度看，过滤器像是大楼的“外围安保”，对所有进出人员进行检查。拦截器则更像是“内部门禁”，只对进入特定区域的人员进行验证。过滤器无法获取Spring的Bean，而拦截器可以充分利用Spring的依赖注入功能。

一个实际的区别体现在执行时机上。过滤器在请求进入Servlet之前就开始工作，而拦截器在DispatcherServlet接收到请求后才开始介入。这种差异决定了它们各自适合的处理场景。

1.3 拦截器的应用场景分析

拦截器的应用场景相当广泛，几乎每个SpringMVC项目都会用到它们。

登录验证是最典型的应用。当用户访问需要身份认证的页面时，拦截器可以自动检查session中是否存在用户信息。如果未登录，就直接重定向到登录页面。这种设计避免了在每个Controller方法中重复编写登录检查代码。

权限控制是另一个重要场景。不同角色的用户可能拥有不同的访问权限。拦截器可以根据用户角色判断是否允许访问某个功能模块。我曾经实现过一个权限拦截器，它通过分析请求URL和用户权限配置，实现了细粒度的访问控制。

日志记录也是拦截器的常见用途。通过拦截器，我们可以统一记录请求信息、执行时间、操作结果等。这对于系统监控和问题排查非常有帮助。性能监控拦截器能够统计方法执行时间，帮助发现系统瓶颈。

其他应用场景还包括参数预处理、防重复提交、跨域请求处理等。拦截器的灵活性让开发者能够根据项目需求定制各种功能，这种设计确实极大地提升了开发效率。 <mvc:interceptors>

<bean class="com.example.LoginInterceptor"/>
<mvc:interceptor>
    <mvc:mapping path="/admin/**"/>
    <mvc:exclude-mapping path="/admin/login"/>
    <bean class="com.example.AuthInterceptor"/>
</mvc:interceptor>

</mvc:interceptors>

@Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {

HttpSession session = request.getSession();
if (session.getAttribute("user") == null) {
    response.sendRedirect("/login");
    return false;
}
return true;

}

public class LoginInterceptor implements HandlerInterceptor {

@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
    String uri = request.getRequestURI();
    
    // 排除登录相关路径
    if (uri.contains("/login") || uri.contains("/register")) {
        return true;
    }
    
    HttpSession session = request.getSession();
    Object user = session.getAttribute("currentUser");
    if (user == null) {
        response.sendRedirect("/login?redirect=" + URLEncoder.encode(uri, "UTF-8"));
        return false;
    }
    
    return true;
}

}

public class SafeInterceptor implements HandlerInterceptor {

@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
    try {
        // 业务逻辑
        return doBusinessLogic(request);
    } catch (BusinessException e) {
        // 业务异常，返回特定错误信息
        response.setStatus(400);
        writeJsonResponse(response, new ErrorResult(e.getMessage()));
        return false;
    } catch (Exception e) {
        // 系统异常，记录日志但继续执行
        logger.error("拦截器执行异常", e);
        return true; // 或者根据需求返回false
    }
}

}