Spring mvc 项目中页面访问不到静态文件,如img , js , css 等

本文详细介绍了在SpringMVC项目中遇到页面无法访问静态文件(如img,js,css等)时的解决方案。包括激活Tomcat的defaultServlet处理静态文件、利用mvc:resources进行静态资源映射、以及使用<mvc:default-servlet-handler/>简化配置。通过这些方法可以确保项目中的静态资源能够正常访问。

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

Spring mvc 项目中页面访问不到静态文件,如img , js , css 等
起因:我们通常在springmvc项目中web.xml配置文件中的内容为:
  <servlet>
  	<servlet-name>springmvc001-servlet</servlet-name>
  	<servlet-class>
		org.springframework.web.servlet.DispatcherServlet  		
  	</servlet-class>
  	<init-param>
  		<param-name>contextConfigLocation</param-name>
  		<param-value>classpath:springmvc001-main.xml</param-value>
  	</init-param>
  	<load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
  	<servlet-name>springmvc001-servlet</servlet-name>
  	<url-pattern>/</url-pattern>
  </servlet-mapping>
这就导致用户的所用请求都被拦截给了DispatcherServlet  
解决办法有三种:
第一种:在web.xml文件中激活Tomcat的defaultServlet来处理静态文件
<!-- 直接添加即可达到效果   有些文章中说要放在dispatcherservlet的后面,我测试了一下,在web.xml文件中没有不存在这个问题-->
	<servlet-mapping>
		<servlet-name>default</servlet-name>       
		<url-pattern>*.jpg</url-pattern>
		<url-pattern>*.gif</url-pattern>
		<url-pattern>*.png</url-pattern>
		<url-pattern>*.js</url-pattern>
		<url-pattern>*.css</url-pattern>
	 </servlet-mapping>

第二种:spring3.0.4以后版本提供了mvc:resources
在springmvc的主配置文件中添加
<!-- 对静态资源文件的访问 -->     
<mvc:annotation-driven />
<mvc:resources mapping="/images/**" location="/images/" />
/images/**映射到 ResourceHttpRequestHandler进行处理,location指定静态资源的位置.可以是web application根目录下、jar包里面,这样可以把静态资源压缩到jar包中。cache-period 可以使得静态资源进行web cache
再例如:
<mvc:resources location="/,classpath:/META-INF/publicResources/" mapping="/resources/**"/>
以上配置将Web根路径"/"及类路径下 /META-INF/publicResources/ 的目录映射为/resources路径。假设Web根路径下拥有images、js这两个资源目录,在images下面有bg.gif图片,在js下面有test.js文件,则可以通过 /resources/images/bg.gif 和 /resources/js/test.js 访问这二个静态资源。 
假设WebRoot还拥有images/bg1.gif 及 js/test1.js,则也可以在网页中通过 /resources/images/bg1.gif 及 /resources/js/test1.js 进行引用


第三种:使用<mvc:default-servlet-handler/>,在springmvc主配置文件中加上这个标签就搞定了,不需要其他的额外的配置。

### 解决方案概述 在 IntelliJ IDEA 中开发 JSP 页面时遇到 CSS、JavaScript 或其他静态资源无法正常加载的问题,通常是因为 Spring MVC 默认拦截了所有的请求,阻止了对静态资源的直接访问。为了使这些资源能够被正确加载,需要进行特定配置。 ### 配置方式一:修改 `spring-mvc` 的配置文件 如果使用的是 XML 方式的配置,在 `spring-servlet.xml` 文件中加入如下配置来指定哪些目录下的资源应该作为公共资源处理[^1]: ```xml <mvc:resources mapping="/static/**" location="/static/" /> <!-- or --> <mvc:default-servlet-handler/> ``` 上述设置允许 `/static/` 路径前缀的所有 URL 请求映射到实际位于 webapp/static 目录中的文件上。 ### 配置方式二:调整项目结构并更新路径引用 确保静态资源(如 images, cssjs 文件)存放在合适的位置,并且相对于 JSP 文件有正确的相对路径。对于 main.jsp 试图引用 ../images/one.jpg 却失败的情况,这可能意味着项目的物理布局并不支持这种相对寻址方法[^2]。建议按照标准 Maven 结构组织项目: ``` src/ └── main/ ├── java/ ├── resources/ └── webapp/ ├── WEB-INF/ │ └── views/ ├── static/ ├── css/ ├── js/ └── img/ └── index.jsp ``` 在此基础上,JSP 文件内的链接应采用绝对路径形式,例如 `<link href="${pageContext.request.contextPath}/static/css/style.css">`. ### 配置方式三:通过 Web 应用程序构建工具 (Maven/Gradle) 当从 Eclipse 导入项目至 IDEA 后可能出现静态资源丢失的现象,此时需确认 pom.xml 或 build.gradle 是否已正确定义依赖项以及插件版本号等信息[^3]。特别是要保证打包过程中不会遗漏任何必要的库或资源配置。 ### 测试部署环境 最后一步是在本地服务器启动应用程序之前检查 Artifact 设置是否正确无误。“Artifact is being deployed, please wait...”提示表明 IDE 正尝试将应用打成 war 包再部署给 Tomcat 使用;因此务必验证 artifact 定义里包含了所有必需的部分,包括但不限于编译后的类文件和前端资产。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值