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 渲染或消息转换器写出。
展开原理
doDispatch获取HandlerExecutionChain(Handler + 拦截器)。- 依次执行
Interceptor.preHandle。 HandlerAdapter.handle:参数绑定、调用 Controller。- 返回
ModelAndView或直接写出响应。 - 执行
postHandle、渲染视图、afterCompletion。 - 异常交给
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 有哪些常见落地坑?
一句话结论
集中在参数绑定、消息转换、异常处理、拦截器顺序、线程安全、文件上传和跨域七类。
清单
@RequestBody与表单混用,流只能读一次。- 日期格式/时区不一致,Jackson 配置缺失。
@Transactional在 Controller 上开启,事务范围过大。- Controller 单例却有可变成员变量。
- 文件上传大小超限,未配置
MultipartConfig。 - 拦截器里写响应后没
return false,继续执行导致重复提交。 - 全局异常把 4xx 都变成 500。
- 静态资源被拦截器拦截。
追问
- 如何统一日期格式?配置
spring.jackson.date-format或自定义JavaTimeModule。 - 上传大文件怎么处理?分片/对象存储直传,避免经过应用内存。
本节自检
- [ ] 能画出 DispatcherServlet 流程
- [ ] 能说出参数解析器链
- [ ] 能区分 Filter 与 Interceptor
- [ ] 能写全局异常处理
- [ ] 能解释内容协商与异步请求