dispatcherservlet 由 servlet 容器(如 tomcat)根据配置自动触发,继承 httpservlet,重写 doservice() 启动 mvc 流程;spring boot 默认注册,路径为 /。

DispatcherServlet 是怎么被触发的
Spring MVC 的整个请求流程起点是 DispatcherServlet,它不是你手动调用的,而是由 Servlet 容器(比如 Tomcat)在收到 HTTP 请求后,根据 web.xml 或基于 Java Config 的 ServletRegistrationBean 配置,把请求派发给它。
关键点在于:这个类继承自 HttpServlet,所以最终走的是 service() → doGet()/doPost() 这条链。Spring 重写了 doService() 方法,在里面封装了真正的 MVC 流程入口。
- 如果你用的是 Spring Boot,默认已自动注册
DispatcherServlet,路径为/,不需要手动配web.xml - 老项目若在
web.xml中配置了url-pattern为/,注意它会覆盖掉容器默认的静态资源处理;加个<init-param><param-name>dispatchOptionsRequest</param-name><param-value>true</param-value></init-param>才能支持OPTIONS预检 - Spring Boot 2.6+ 默认禁用
/resources/**等静态路径映射,如果发现 CSS/JS 404,要检查是否误删了WebMvcConfigurer中对addResourceHandlers()的配置
HandlerMapping 怎么找到对应 Controller 方法
当 DispatcherServlet 收到请求后,第一件事是查 HandlerMapping,也就是“谁来处理这个 URL”。它不只看路径,还会结合 HTTP 方法、请求头(如 Content-Type)、参数(@RequestParam)、甚至自定义条件(@RequestMapping(params = "format=json"))。
常见实现有 RequestMappingHandlerMapping(处理 @Controller + @RequestMapping),它内部维护了一个 mappingRegistry,把每个 HandlerMethod 和匹配条件缓存起来。
立即学习“Java免费学习笔记(深入)”;
- 多个
@RequestMapping值写成数组形式:@RequestMapping({"/user", "/api/user"}),等价于两个独立映射 - 路径变量
{id}和通配符**会影响匹配优先级:精确路径 > 路径变量 > 通配符;/user/123会优先匹配@GetMapping("/user/{id}")而不是@GetMapping("/user/**") - 如果出现
No mapping for GET /xxx错误,先确认 Controller 类是否加了@Controller(或@RestController),再确认包是否被@ComponentScan扫描到
HandlerAdapter 如何执行 Controller 方法并返回 ModelAndView
找到 HandlerMethod 后,DispatcherServlet 会委托给 HandlerAdapter 来真正调用它。最常用的是 RequestMappingHandlerAdapter,它负责解析参数(@PathVariable、@RequestBody、@ModelAttribute 等)、调用方法、处理返回值。
返回值类型决定后续流程:String 视为逻辑视图名,ModelAndView 包含视图和模型数据,@ResponseBody 注解的方法则跳过视图解析,直接写响应体。
-
@RequestBody要求请求头带Content-Type: application/json,否则会报HttpMessageNotReadableException -
@ModelAttribute参数如果没在请求中提供,会尝试调用无参构造函数创建实例;若类没有无参构造,会抛InstantiationException - 返回
void且没加@ResponseBody,Spring 会尝试用请求路径推断视图名(如/user/list→user/list),但容易出错,建议显式返回String或加注解
ViewResolver 怎么把逻辑名转成真实页面
只有返回值是逻辑视图名(如 "user/detail")时,才会走到 ViewResolver。它不负责渲染,只是把名字拼装成真实路径,比如加上前缀 /WEB-INF/views/ 和后缀 .jsp,然后交给 InternalResourceView 去 RequestDispatcher.forward()。
Spring Boot 默认使用 ThymeleafViewResolver 或 InternalResourceViewResolver(JSP 场景),但要注意 JSP 在嵌入式 Tomcat 中默认不可用 —— 因为 spring-boot-starter-tomcat 是 provided 作用域,不会打包 JSP 编译器。
- Thymeleaf 模板默认路径是
classpath:/templates/,后缀是.html;改配置要动spring.thymeleaf.prefix和suffix - 用
redirect:或forward:开头的字符串会绕过ViewResolver,直接交由 Servlet 容器处理重定向或转发 - 如果页面打开空白但控制台没报错,先检查浏览器是否收到 200 但响应体为空 —— 很可能是
ViewResolver拼出来的路径根本不存在,又没配defaultView,导致静默失败
整个流程里最容易被忽略的是组件初始化顺序和 Bean 加载时机:比如自定义 HandlerExceptionResolver 必须在 DispatcherServlet 初始化完成前注册,否则 500 错误可能进不了你的全局异常处理器;还有 @InitBinder 方法只对当前 Controller 生效,跨 Controller 复用得靠 @ControllerAdvice。










