本文详解 tomcat 应用中静态资源（如 css）路径失效的根本原因，重点说明 web 应用资源访问的上下文路径机制，并提供基于标准 maven 结构的正确引用方式、常见错误排查及最佳实践。
本文详解 tomcat 应用中静态资源（如 css）路径失效的根本原因，重点说明 web 应用资源访问的上下文路径机制，并提供基于标准 maven 结构的正确引用方式、常见错误排查及最佳实践。
在基于 Servlet 规范的 Java Web 应用（如使用 Tomcat 作为容器）中，JSP 页面中 标签的 href 属性并非基于文件系统路径解析，而是相对于当前请求的上下文路径（Context Path）进行 HTTP 路径解析。这意味着： 实际会向服务器发起一个形如 /your-app/css/style.css 的 HTTP GET 请求——而该路径是否能命中真实资源，完全取决于你的项目目录结构是否符合 Servlet 容器的静态资源映射规则。
✅ 正确的项目结构与资源映射
标准 Maven Web 项目（如使用 maven-archetype-webapp 或 Spring Boot 的传统 WAR 模式）中，静态资源应置于 src/main/webapp/ 目录下（而非 src/main/resources/）。Tomcat 默认将 webapp/ 下的非 WEB-INF/ 和 META-INF/ 子目录视为可公开访问的 Web 根目录（即 Document Root）。
推荐结构如下：
src/main/webapp/ ├── index.jsp ← 访问路径：/index.jsp ├── css/ │ └── style.css ← 访问路径：/css/style.css ├── js/ └── images/
此时，在 index.jsp 中应使用相对于 Web 应用根目录的路径：
立即学习“前端免费学习笔记（深入）”；
<link href="/css/style.css" rel="stylesheet" /> <!-- 注意开头的 '/' —— 表示从 Context Path 根开始 -->
⚠️ 若你的应用部署上下文为 /myapp（如 http://localhost:8080/myapp/index.jsp），则上述写法实际请求的是 http://localhost:8080/myapp/css/style.css，完全匹配资源位置。
❌ 常见错误分析
错误 1：误用 src/main/resources/static/
resources/static/ 是 Spring Boot 的约定目录（仅对嵌入式 Tomcat + Spring MVC 自动配置生效），普通 Tomcat 部署的 WAR 包不识别此路径。将 CSS 放在此处会导致 404。错误 2：使用相对路径 css/style.css（无前导 /）
此写法是相对于当前页面 URL 路径。若用户访问的是 /user/profile.jsp，浏览器会尝试请求 /user/css/style.css，而非 /css/style.css，极易出错。错误 3：硬编码 ../../resources/static/...
这种路径依赖具体部署层级和请求 URL，违反 Web 资源定位原则，不可维护且必然失败。
✅ 推荐写法（兼顾可移植性）
为避免硬编码上下文路径，建议使用 JSTL 或 EL 表达式动态获取 Context Path：
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <link href="<c:url value='/css/style.css' />" rel="stylesheet" />
或原生 EL（需启用）：
<link href="${pageContext.request.contextPath}/css/style.css" rel="stylesheet" />✅ 两者均能生成正确的绝对路径，例如 /myapp/css/style.css，无论应用部署在根路径 / 还是子路径 /myapp 下均可正常工作。
? 快速验证步骤
- 确认 CSS 文件物理路径为 src/main/webapp/css/style.css；
- 清理并重新构建项目（Maven → clean package），确保 WAR 中包含 css/style.css；
- 启动 Tomcat，直接在浏览器访问 http://localhost:8080/your-app/css/style.css —— 应返回 CSS 内容（HTTP 200）；
- 再访问 index.jsp，检查浏览器开发者工具 Network 标签页，确认 CSS 请求状态码为 200。
? 提示：若使用 Spring Boot，且希望沿用 resources/static/，请确保以 jar 方式运行（默认支持），或在 application.properties 中配置 server.servlet.context-path 并使用 @Controller 映射静态资源——但此属框架层方案，不适用于纯 Tomcat WAR 部署场景。
遵循以上规范，即可彻底解决 Tomcat 下 JSP 无法加载 CSS 的问题，确保静态资源路径清晰、可靠、可维护。
