<mvn:default-servlet-handler/>标签作用

最新推荐文章于 2025-04-27 15:56:10 发布

原创最新推荐文章于 2025-04-27 15:56:10 发布 · 636 阅读

0 ·

CC 4.0 BY-SA版权

spring mvc 专栏收录该内容

12 篇文章

订阅专栏

本文介绍了解决Spring MVC框架中静态文件如CSS、JS和图片无法直接访问的问题。提出了三种解决方案：激活Tomcat的defaultServlet处理静态文件、使用mvc:resources配置静态资源路径、启用mvc:default-servlet-handler利用容器默认Servlet处理静态资源。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

servlet在找页面时，走的是dispatcherServlet路线。找不到的时候会报404

加上这个默认的servlet时候，servlet在找不到的时候会去找静态的内容。

另外一篇文章介绍了访问静态文件的几种方法：

访问到静态的文件，如jpg,js,css

如何你的`DispatcherServlet拦截 .do这样的URL，就不存在访问不到静态资源的问题。如果你的DispatcherServlet拦截“/”，拦截了所有的请求，同时对.js,*.jpg的访问也就被拦截了。`

目的：可以正常访问静态文件，不要找不到静态文件报404。

方案一：激活Tomcat的defaultServlet来处理静态文件

[html]view plaincopy 
    
 
    
 <servlet-mapping>     
     <servlet-name>default</servlet-name>    
     <url-pattern>*.jpg</url-pattern>       
 </servlet-mapping>      
 <servlet-mapping>         
     <servlet-name>default</servlet-name>      
     <url-pattern>*.js</url-pattern>      
 </servlet-mapping>      
 <servlet-mapping>          
     <servlet-name>default</servlet-name>         
     <url-pattern>*.css</url-pattern>        
 </servlet-mapping>      
 要配置多个，每种文件配置一个  

要写在DispatcherServlet的前面，让 defaultServlet先拦截，这个就不会进入spring了

Tomcat, Jetty, JBoss, and GlassFish 默认 Servlet的名字 -- "default"
Google App Engine 默认 Servlet的名字 -- "_ah_default"
Resin 默认 Servlet的名字 -- "resin-file"
WebLogic 默认 Servlet的名字 -- "FileServlet"
WebSphere 默认 Servlet的名字 -- "SimpleFileServlet"

方案二：在spring3.0.4以后版本提供了mvc:resources
mvc:resources 的使用方法：

[html]view plaincopy 
    
 <!-- 对静态资源文件的访问 -->      
 <mvc:resources mapping="/images/**" location="/images/" />

[html] view plain copy

<span style="font-weight: normal;">mapping<span style="font-family: Arial; line-height: 1.5em; ">映射到ResourceHttpRequestHandler进行处理
location指定静态资源的位置.可以是web application根目录下、jar包里面，这样可以把静态资源压缩到jar包中
cache-period 可以使得静态资源进行web cache </span></span>

如果出现下面的错误，可能是没有配置<mvc:annotation-driven />的原因。
报错WARNING: No mapping found for HTTP request with URI [/mvc/user/findUser/lisi/770] in DispatcherServlet with name 'springMVC'

使用<mvc:resources/>元素,把mapping的URI注册到SimpleUrlHandlerMapping的urlMap中,key为mapping的URI pattern值,而value为ResourceHttpRequestHandler,这样就巧妙的把对静态资源的访问由HandlerMapping转到ResourceHttpRequestHandler处理并返回,所以就支持classpath目录,jar包内静态资源的访问.另外需要注意的一点是,不要对SimpleUrlHandlerMapping设置defaultHandler.因为对static uri的defaultHandler就是ResourceHttpRequestHandler,否则无法处理static resources request.

方案三，使用<mvc:default-servlet-handler/>

[html]view plaincopy 
    
 <mvc:default-servlet-handler/>

会把"/" url,注册到SimpleUrlHandlerMapping的urlMap中,把对静态资源的访问由HandlerMapping转到org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler处理并返回.DefaultServletHttpRequestHandler使用就是各个Servlet容器自己的默认Servlet.

补充说明：多个HandlerMapping的执行顺序问题：

DefaultAnnotationHandlerMapping的order属性值是：0
<mvc:resources/ >自动注册的 SimpleUrlHandlerMapping的order属性值是： 2147483646

<mvc:default-servlet-handler/>自动注册的SimpleUrlHandlerMapping 的order属性值是： 2147483647

spring会先执行order值比较小的。当访问一个a.jpg图片文件时，先通过 DefaultAnnotationHandlerMapping 来找处理器，一定是找不到的，我们没有叫a.jpg的Action。再按order值升序找，由于最后一个 SimpleUrlHandlerMapping 是匹 "/"的，所以一定会匹配上，再响应图片。