SpringMVC中单独配置＜mvc:default-servlet-handler/＞ 导致 Controller失效

① DispatcherServlet的映射为/

如果在spring-mvc.xml 拦截方式如下配置(也就是覆盖容器的默认Servlet的映射)：

<servlet>
    <servlet-name>spring</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 可以自定义servlet.xml配置文件的位置和名称，默认为WEB-INF目录下，名称为[<servlet-name>]-servlet.xml，如spring-servlet.xml
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/spring-servlet.xml</param-value>&nbsp; 默认
    </init-param>
    -->
    <load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
    <servlet-name>spring</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>
 //...

② <mvc:default-servlet-handler/>解决静态资源访问

如果①中配置实例，那么所有的请求都会被拦截,包括静态资源。

• '/' 将会替换掉容器的default servlet, 将会处理所有其他handler(Servlet)都不处理的访问请求.

• 如果web.xml没有配置其他特殊路径的servlet, 基本上所有的请求都交由DispatcherServlet处理.

• 将不会再访问容器中原始默认的servlet(你对静态资源的访问就是通过容器默认servlet处理的)，故而静态资源将不可访问！

例如此时访问vue.js，将提示如下

如果想要解决访问静态资源问题，通常会配置如下标签：

<mvc:default-servlet-handler/>

该标签的xsd文档说明如下：

• 配置一个handler(DefaultServletHttpRequestHandler)通过转发到servlet容器的默认servlet来处理静态资源
• 使用该handler允许DispatcherServlet 的url-pattern 为'/'，同时仍然使用Servlet容器让其去处理静态资源
• 该handler将会转发所有的请求到Servlet容器的default serlvet
• 因此，它在所有其他URL HandlerMappings的顺序中保持最后一个是很重要的
• 你可以使用两种方式去保证你的handler mapping 的order属性值小于DefaultServletHttpRequestHandler 对应的handler mapping的order属性值：使用<mvc:annotation-driven/>标签或者手动配置HandlerMapping实例并设置其order属性值
• 请确保将其order属性设置为低于DefaultServletHttpRequestHandler的值，即Integer.MAX_VALUE。

③ Controller失效

新的问题出现了，你会发现以前的Controller不能访问了！那么为什么会出现这个情况？default-servlet-handler将在SpringMVC上下文中定义一个DefaultServletHttpRequestHandler。

DefaultServletHttpRequestHandler的javadoc：

• 使用servlet容器的default servlet处理静态资源
• 当DispatcherServlet url-pattern为 ‘/’时(其会覆盖Servlet容器对静态资源的默认 处理)，该handler将会使用‘/*’去匹配请求路径。
• 到该处理程序的映射通常应作为链中的最后一个进行排序，以便它仅在无法匹配其他更具体的映射（例如controller）时执行。

即，当DispatcherServlet url-pattern为 ‘/’时，该handler将会使用‘/*’去匹配请求路径。参考servlet的url-pattern规则可知 '/*'可以拦截一切请求。因为'/'将servlet定义为默认serlvet，在没有精确匹配servlet出现前，'/*'将拥有最高的优先级。

这是很严重的，/*可以拦截路径和资源型的请求，并转发到默认的serlvet。也就是说，静态资源此时可以由默认default servlet进行处理，但是default servlet不能处理你的业务请求(mapping)。

所以，需要保证该handler对应的handler mapping在执行顺序中为最后！

• 使用<mvc:annotation-driven/>标签
• 手动配置HandlerMapping实例并设置其order属性值使其小于DefaultServletHttpRequestHandler的值，即Integer.MAX_VALUE

④ <mvc:annotation-driven />解决controller失效

解决办法：配置下面标签

<mvc:annotation-driven />

至于为什么这样解决，查看<mvc:default-servlet-handler/>的xsd说明文档就明白了。

⑤ 不同情况下的HandlerAdapter、HandlerExceptionResolver和HandlerMapping

在springmvc.xml中，经常会配置<mvc:annotation-driven/>和<mvc:default-servlet-handler/>。那么它们所带来的影响呢？

类	都不配置	仅配置<mvc:default-servlet-handler/>	仅配置<mvc:annotation-driven/>	都配置
HttpRequestHandlerAdapter	有	有	有	有
SimpleControllerHandlerAdapter	有	有	有	有
AnnotationMethodHandlerAdapter	有
RequestMappingHandlerAdapter			有	有
ExceptionHandlerExceptionResolver			有	有
AnnotationMethodHandlerExceptionResolver	有	有
ResponseStatusExceptionResolver	有	有	有	有
DefaultHandlerExceptionResolver	有	有	有	有
RequestMappingHandlerMapping			有	有
BeanNameUrlHandlerMapping	有	有	有	有
DefaultAnnotationHandlerMapping	有
SimpleUrlHandlerMapping		有		有

<mvc:annotation-driven/>注入了:

• RequestMappingHandlerAdapter(替代了AnnotationMethodHandlerAdapter)，

• ExceptionHandlerExceptionResolver(替代了AnnotationMethodHandlerExceptionResolver)

• RequestMappingHandlerMapping(替代了DefaultAnnotationHandlerMapping) 。

其中 AnnotationMethodHandlerAdapter是过期类，3.2之后被RequestMappingHandlerAdapter替代。

⑥ DispatcherServlet不拦截jsp请求

前面说的当DispatcherServlet配置为’/’, 将会覆盖default servlet, 将会处理所有其他Servlet都不处理的访问请求。所以这里不拦截拦截.jsp, .jspx.的请求, 一定有其他地方拦截了该请求, 但是仔细查找web.xml并没有发现其他的servlet，那一定是在容器中定义的。

果不其然, 在%TOMCAT_HOME%/conf/web.xml中继承过来的JspServlet会处理该请求.

该xml配置了两个servlet：

<servlet>
     <servlet-name>default</servlet-name>
     <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
     <init-param>
         <param-name>debug</param-name>
         <param-value>0</param-value>
     </init-param>
     <init-param>
         <param-name>listings</param-name>
         <param-value>false</param-value>
     </init-param>
     <load-on-startup>1</load-on-startup>
 </servlet>
 
<servlet>
     <servlet-name>jsp</servlet-name>
     <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
     <init-param>
         <param-name>fork</param-name>
         <param-value>false</param-value>
     </init-param>
     <init-param>
         <param-name>xpoweredBy</param-name>
         <param-value>false</param-value>
     </init-param>
     <load-on-startup>3</load-on-startup>
 </servlet>

<!-- The mapping for the default servlet -->
 <servlet-mapping>
     <servlet-name>default</servlet-name>
     <url-pattern>/</url-pattern>
 </servlet-mapping>

 <!-- The mappings for the JSP servlet -->
 <servlet-mapping>
     <servlet-name>jsp</servlet-name>
     <url-pattern>*.jsp</url-pattern>
     <url-pattern>*.jspx</url-pattern>
 </servlet-mapping>

这也就是为什么我们直接访问不在WEB-INF的jsp, 可以直接找到并解析的原因了.