深入解析Spring Boot请求处理流程：从HTTP请求到Controller的完整流程

原创已于 2025-03-19 12:35:49 修改 · 1.3k 阅读

30 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #spring #java

于 2025-03-19 12:34:55 首次发布

深入解析Spring Boot请求处理流程：从HTTP请求到Controller的完整流程

引言

在Spring Boot应用开发中，理解HTTP请求如何被处理并最终到达Controller方法，是优化性能、实现定制化功能的关键。本文将深入剖析一个请求从进入服务器到被Controller处理的完整流程，揭示每个核心环节的运作机制，并给出实际开发中的最佳实践。

一、Servlet容器处理阶段

1.1 容器初始化与请求接收

Spring Boot默认使用内嵌Servlet容器（Tomcat/Jetty/Undertow），启动时会自动完成以下操作：

创建Server实例并绑定端口
初始化连接池和线程池
注册默认的ErrorPage过滤器

当请求到达时，容器会：

创建HttpServletRequest和HttpServletResponse对象
分配线程处理请求
进入Filter处理链

1.2 Filter链处理

Filter的执行顺序对应用行为有重要影响，典型应用场景包括：

// 跨域过滤器配置示例
@Bean
public FilterRegistrationBean<CorsFilter> corsFilter() {
    FilterRegistrationBean<CorsFilter> bean = new FilterRegistrationBean<>();
    bean.setFilter(new CorsFilter());
    bean.setOrder(Ordered.HIGHEST_PRECEDENCE); // 设置最高优先级
    return bean;
}

// 自定义日志过滤器
public class RequestLogFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) {
        long start = System.currentTimeMillis();
        chain.doFilter(request, response);
        long cost = System.currentTimeMillis() - start;
        log.info("Request {} cost {}ms", ((HttpServletRequest)request).getRequestURI(), cost);
    }
}

二、Spring MVC核心处理流程

2.1 DispatcherServlet：中央调度器

作为Spring MVC的唯一入口，DispatcherServlet承担着：

初始化WebApplicationContext
维护HandlerMapping列表
协调各组件协作

2.2 HandlerMapping路由解析

Spring Boot支持多种映射策略：

映射类型	实现类	说明
注解映射	RequestMappingHandlerMapping	处理@RequestMapping
简单URL映射	SimpleUrlHandlerMapping	静态资源映射
Bean名称映射	BeanNameUrlHandlerMapping	根据Bean名称映射

2.3 拦截器（Interceptor）体系

拦截器执行顺序示例：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new LogInterceptor()).order(1);
        registry.addInterceptor(new AuthInterceptor()).order(2);
        registry.addInterceptor(new CacheInterceptor()).order(3);
    }
}

典型拦截器方法：

public class JwtInterceptor implements HandlerInterceptor {
    
    @Override
    public boolean preHandle(HttpServletRequest request, 
                             HttpServletResponse response, 
                             Object handler) {
        String token = request.getHeader("Authorization");
        if (!jwtUtil.validate(token)) {
            response.sendError(401, "Invalid token");
            return false;
        }
        return true;
    }
    
    @Override
    public void postHandle(...) {
        // 在Controller方法执行后，视图渲染前
    }
    
    @Override
    public void afterCompletion(...) {
        // 整个请求完成后（包括视图渲染）
    }
}

三、参数处理机制

3.1 参数解析器（HandlerMethodArgumentResolver）

Spring Boot内置40+个参数解析器，支持：

基础类型参数（@RequestParam）
路径变量（@PathVariable）
请求体（@RequestBody）
会话属性（@SessionAttribute）
自定义类型转换

3.2 消息转换器（HttpMessageConverter）

常见转换器配置示例：

@Configuration
public class WebConfig {
    
    @Bean
    public HttpMessageConverters customConverters() {
        Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder()
                .indentOutput(true)
                .serializationInclusion(JsonInclude.Include.NON_NULL);
        return new HttpMessageConverters(
            new MappingJackson2HttpMessageConverter(builder.build()),
            new ProtobufHttpMessageConverter()
        );
    }
}

四、核心处理流程图解

五、性能优化建议

Filter优化：
- 将耗时操作（如日志记录）放在Chain.doFilter()之后
- 使用@WebFilter时注意组件扫描范围
拦截器优化：
- 避免在preHandle中执行耗时操作
- 合理使用路径匹配排除不需要的请求
参数解析优化：
- 对高频请求使用@ModelAttribute缓存
- 自定义Converter处理特殊格式

六、常见问题排查

Q1：Filter不生效可能原因

未添加@Component注解
包不在组件扫描范围内
使用@WebFilter但未启用@ServletComponentScan

Q2：拦截器与Filter执行顺序

FilterChain按注册顺序执行
DispatcherServlet处理请求
拦截器按注册逆序执行preHandle
拦截器按注册顺序执行postHandle

Q3：如何自定义400错误处理

@ControllerAdvice
public class CustomExceptionHandler {
    
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ErrorResult handleValidationException(MethodArgumentNotValidException ex) {
        // 处理参数校验错误
    }
}