罗罗编程学习记录
本页内容 展开查看

06.2.1.5 Spring MVC 与请求处理

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.2 Java Spring 生态 / 06.2.1 Spring Framework

本节要解决的问题

  • 一个 HTTP 请求从 Tomcat 到 Controller 方法,中间经过了什么?
  • 参数是怎么从字符串变成对象的?
  • 为什么拦截器、过滤器、AOP 的先后顺序总记混?

06.2.1.5-001 请描述 DispatcherServlet 处理请求的完整流程。

一句话结论

DispatcherServlet 接收请求 → 解析 HandlerMapping 找到处理器 → 通过 HandlerAdapter 调用 → 处理返回值 → ViewResolver 渲染或消息转换器写出。

展开原理

  1. doDispatch 获取 HandlerExecutionChain(Handler + 拦截器)。
  2. 依次执行 Interceptor.preHandle。
  3. HandlerAdapter.handle:参数绑定、调用 Controller。
  4. 返回 ModelAndView 或直接写出响应。
  5. 执行 postHandle、渲染视图、afterCompletion。
  6. 异常交给 HandlerExceptionResolver 链。

图示

Tomcat → FilterChain → DispatcherServlet
  → HandlerMapping 找 Controller
  → Interceptor.preHandle
  → HandlerAdapter 参数绑定/调用
  → 返回值处理(@ResponseBody / ModelAndView)
  → Interceptor.postHandle
  → 视图渲染 / 消息转换写出
  → afterCompletion

常见误区

  • DispatcherServlet 不是 Controller,它只负责调度。
  • 拦截器在 preHandle 返回 false 时,后续拦截器和 Controller 都不执行。

追问

  • 什么时候执行 afterCompletion?无论是否异常,只要 preHandle 返回 true 都会执行。
  • 异常处理发生在哪一步?Controller 抛出后由 processDispatchResult 调用异常解析器。

06.2.1.5-002 HandlerMapping 和 HandlerAdapter 分别做什么?

一句话结论

HandlerMapping 负责“URL → Handler”的映射;HandlerAdapter 负责“怎么调用这个 Handler”,屏蔽不同类型处理器的差异。

展开原理

  • RequestMappingHandlerMapping 扫描 @RequestMapping,构建 RequestMappingInfo 与方法的映射。
  • RequestMappingHandlerAdapter 负责参数解析、调用方法、返回值处理。
  • 其他适配器:SimpleControllerHandlerAdapter、HttpRequestHandlerAdapter。

示例

@RestController
@RequestMapping("/users")
public class UserController {
    @GetMapping("/{id}")
    public User get(@PathVariable Long id) { ... }
}

常见误区

  • 只有 @Controller 被扫描还不够,方法上必须有映射注解。
  • 映射冲突(两个方法同一路径+方法)启动时报 Ambiguous mapping。

追问

  • 为什么需要 Adapter 模式?让 DispatcherServlet 不依赖具体 Controller 类型。
  • 映射注册在什么时候?容器启动时由 RequestMappingHandlerMapping 初始化。

06.2.1.5-003 Spring MVC 的参数绑定是怎么完成的?

一句话结论

由 HandlerMethodArgumentResolver 链完成:路径变量、请求参数、请求体、请求头、Cookie、Session、Model 等各有对应解析器。

常见解析器

注解/类型 解析器 来源
@PathVariable PathVariableMethodArgumentResolver URL 模板
@RequestParam RequestParamMethodArgumentResolver query/form
@RequestBody RequestResponseBodyMethodProcessor body + 消息转换器
@RequestHeader RequestHeaderMethodArgumentResolver header
@ModelAttribute ModelAttributeMethodProcessor 表单/查询参数
@CookieValue ServletCookieValueMethodArgumentResolver cookie

示例

@PostMapping("/users/{id}")
public User update(@PathVariable Long id,
                   @RequestBody UserUpdateReq req,
                   @RequestHeader("X-Tenant") String tenant) { ... }

常见误区

  • @RequestBody 只能读一次流;重复读取需要包装 ContentCachingRequestWrapper。
  • 表单和 JSON 不能同时用同一个 @RequestBody 接收。

追问

  • 自定义参数解析怎么做?实现 HandlerMethodArgumentResolver 并注册到 RequestMappingHandlerAdapter。
  • 参数校验在哪一层?@Valid 由 ModelAttributeMethodProcessor 或 RequestResponseBodyMethodProcessor 触发。

06.2.1.5-004 返回值是如何写回响应的?

一句话结论

@ResponseBody/@RestController 由 RequestResponseBodyMethodProcessor 选择 HttpMessageConverter 序列化;否则返回 ModelAndView 交给视图解析器。

展开原理

  • 返回值 handler 链:ModelAndViewReturnValueHandler、RequestResponseBodyMethodProcessor、ViewNameReturnValueHandler 等。
  • 内容协商:根据 Accept、produces、converter 支持的类型选择。
  • JSON 常用 MappingJackson2HttpMessageConverter。

示例

@RestController
public class UserController {
    @GetMapping("/u/{id}")
    public ResponseEntity<User> get(@PathVariable Long id) {
        return ResponseEntity.ok(userService.get(id));
    }
}

常见误区

  • 返回 String 在 @RestController 下是 JSON 字符串,在 @Controller 下是视图名。
  • 返回 null 不等于 404,通常是 200 空 body。

追问

  • 如何自定义序列化?注册 ObjectMapper 模块或自定义 HttpMessageConverter。
  • 为什么返回对象变成 {}?getter 缺失、字段被忽略、序列化配置错误。

06.2.1.5-005 拦截器和过滤器有什么区别?

一句话结论

Filter 属于 Servlet 规范,在 DispatcherServlet 之前,能包装请求/响应;Interceptor 属于 Spring MVC,在 Handler 调用前后,能访问 Handler 信息。

对比

维度 Filter Interceptor
规范 Servlet Spring MVC
位置 DispatcherServlet 前 Handler 前后
能否拿到 Controller 方法 否 是(HandlerMethod)
典型用途 编码、CORS、日志、安全头 登录校验、权限、MVC 日志

示例

public class AuthInterceptor implements HandlerInterceptor {
    public boolean preHandle(HttpServletRequest req, HttpServletResponse resp, Object handler) {
        if (!tokenOk(req)) { resp.setStatus(401); return false; }
        return true;
    }
}

常见误区

  • 拦截器只能拦截 Spring MVC 的请求,静态资源/其他 Servlet 不一定经过。
  • Filter 中读 body 会导致后续 Controller 读不到,需要包装缓存。

追问

  • 顺序怎么排?Filter(@Order/web.xml)→ Interceptor(preHandle 正序,postHandle/afterCompletion 逆序)。
  • 跨域为什么常在 Filter 处理?因为预检请求可能不到 Controller。

06.2.1.5-006 如何做全局异常处理?

一句话结论

用 @RestControllerAdvice + @ExceptionHandler 捕获 Controller 异常并统一返回;也可实现 HandlerExceptionResolver 处理更底层异常。

示例

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(BizException.class)
    public ResponseEntity<ApiError> biz(BizException e) {
        return ResponseEntity.badRequest().body(new ApiError(e.getCode(), e.getMessage()));
    }

    @ExceptionHandler(Exception.class)
    public ResponseEntity<ApiError> unknown(Exception e) {
        log.error("unexpected", e);
        return ResponseEntity.status(500).body(new ApiError("INTERNAL", "系统繁忙"));
    }
}

常见误区

  • 异常被 Controller 内部 catch 后不再抛出,全局处理器收不到。
  • 返回 200 包一个错误码,破坏 HTTP 语义;要区分业务错误与系统错误。

追问

  • @ExceptionHandler 的匹配优先级?越具体的异常类型优先。
  • 异常处理里还能回滚事务吗?若异常在事务拦截器之前被处理,事务可能已提交;通常在 Controller 层处理时事务已结束。

06.2.1.5-007 Spring 如何处理跨域请求?

一句话结论

用 @CrossOrigin、CorsFilter 或 WebMvcConfigurer.addCorsMappings 配置允许的来源、方法、头;非简单请求要先处理 OPTIONS 预检。

示例

@Configuration
public class CorsConfig implements WebMvcConfigurer {
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/api/**")
                .allowedOrigins("https://app.example.com")
                .allowedMethods("GET", "POST", "PUT", "DELETE")
                .allowCredentials(true);
    }
}

常见误区

  • allowedOrigins("*") 与 allowCredentials(true) 不能同时用(浏览器会拒绝)。
  • 只在 Controller 加 @CrossOrigin,预检请求可能仍被安全过滤器拦截。

追问

  • 预检请求会带 Cookie 吗?默认不带,需 withCredentials 且服务端允许。
  • 网关和服务端都配 CORS 会怎样?响应头重复,浏览器可能报错。

06.2.1.5-008 内容协商是怎么工作的?

一句话结论

根据请求的 Accept、URL 后缀、produces 条件,选择能处理的 HttpMessageConverter 或视图,返回对应媒体类型。

展开原理

  • ContentNegotiationManager 解析策略:AcceptHeader、PathExtension、Parameter、Fixed。
  • RequestMappingInfo 的 produces 参与匹配。
  • 找不到合适 converter 时抛 HttpMediaTypeNotAcceptableException(406)。

示例

@GetMapping(value = "/user", produces = MediaType.APPLICATION_JSON_VALUE)
public User user() { ... }

常见误区

  • 客户端 Accept: */* 时按服务端默认顺序选,可能返回 XML 而不是 JSON。
  • 响应已提交后再改 content-type 无效。

追问

  • 如何默认返回 JSON?配置 defaultContentType 或调整 converter 顺序。
  • 文件下载怎么设置?produces=application/octet-stream + Content-Disposition。

06.2.1.5-009 Spring MVC 的异步请求怎么做?

一句话结论

Controller 返回 Callable、DeferredResult、WebAsyncTask 或 ResponseBodyEmitter,Servlet 线程释放,结果由另一个线程写回。

示例

@GetMapping("/slow")
public DeferredResult<String> slow() {
    DeferredResult<String> result = new DeferredResult<>(3000L, "timeout");
    executor.submit(() -> result.setResult("done"));
    return result;
}

常见误区

  • 异步请求不等于业务异步;数据库/远程调用仍可能阻塞工作线程。
  • DeferredResult 超时后要清理资源,避免任务泄漏。

追问

  • 异步请求的事务边界?事务绑定原线程,异步线程不继承,需单独处理。
  • Spring Boot 3 还用这个吗?WebFlux 是另一套响应式模型,MVC 异步仍可用。

06.2.1.5-010 Spring MVC 有哪些常见落地坑?

一句话结论

集中在参数绑定、消息转换、异常处理、拦截器顺序、线程安全、文件上传和跨域七类。

清单

  1. @RequestBody 与表单混用,流只能读一次。
  2. 日期格式/时区不一致,Jackson 配置缺失。
  3. @Transactional 在 Controller 上开启,事务范围过大。
  4. Controller 单例却有可变成员变量。
  5. 文件上传大小超限,未配置 MultipartConfig。
  6. 拦截器里写响应后没 return false,继续执行导致重复提交。
  7. 全局异常把 4xx 都变成 500。
  8. 静态资源被拦截器拦截。

追问

  • 如何统一日期格式?配置 spring.jackson.date-format 或自定义 JavaTimeModule。
  • 上传大文件怎么处理?分片/对象存储直传,避免经过应用内存。

本节自检

  • [ ] 能画出 DispatcherServlet 流程
  • [ ] 能说出参数解析器链
  • [ ] 能区分 Filter 与 Interceptor
  • [ ] 能写全局异常处理
  • [ ] 能解释内容协商与异步请求