本文详解 tomcat web 应用中静态文件（如 brochure.pdf）的合理存放路径与 html 引用方式，解决因路径错误导致的“failed – no file”下载失败问题。核心在于理解 tomcat 的目录结构与资源访问机制。
在 Tomcat 中，只有部署在 Web 应用根目录（即 webapps/应用名/ 下、且位于 WEB-INF 目录之外）的资源，才能被客户端直接访问和下载。你当前遇到的 "Failed – No file" 错误，根本原因在于文件路径配置违反了 Tomcat 的资源服务规则。
❌ 错误路径分析
- webapps/brochure.pdf：该路径位于 webapps 根目录下，不属于任何 Web 应用上下文，Tomcat 默认不提供此路径下的静态资源服务（相当于“Web 服务器根外”的文件）。
- ROOT/WEB-INF/../../contactUs.jsp：这种写法逻辑混乱——WEB-INF 是受保护目录，其上级是 ROOT，再上一级已脱离 Web 应用范围；JSP 文件实际应位于 webapps/ROOT/ 下（如 webapps/ROOT/contactUs.jsp），否则无法被容器加载。
✅ 正确做法：将 PDF 放入 Web 应用根目录
假设你的应用部署为默认 ROOT 应用（即通过 http://localhost:8080/ 访问），请按以下步骤操作：
将 brochure.pdf 复制到 webapps/ROOT/ 目录下
✅ 正确路径示例：webapps/ROOT/brochure.pdf
（与 about-us.jsp、careers.jsp 等同级）在 JSP 中使用相对或上下文无关的路径引用
推荐使用绝对路径（以 / 开头），避免依赖 pageContext.request.contextPath 的冗余拼接：
<li><a href="/brochure.pdf" download="UserGuide.pdf">User Guide</a></li>
? 说明：/brochure.pdf 表示从 Web 应用根路径（即 http://host:port/）开始查找，Tomcat 会自动映射到 webapps/ROOT/brochure.pdf。download 属性指定下载时的默认文件名（可选，增强用户体验）。
⚠️ 注意事项
- 不要放在 WEB-INF/ 或其子目录中：该目录下所有内容禁止外部直接访问（安全设计），即使路径写对也会返回 404。
- 避免使用 ../ 跨目录跳转：JSP 中的路径解析基于请求 URL，而非文件系统物理路径；../ 在浏览器端无意义，且易引发路径混淆。
-
重启 Tomcat 非必需，但建议刷新资源缓存：首次放置文件后，若仍 404，请检查：
- 文件权限是否允许读取；
- 浏览器是否缓存了旧响应（可尝试 Ctrl+F5 或隐身窗口测试）；
- Tomcat 日志（logs/catalina.out）是否有 FileNotFoundException 提示。
✅ 验证方法
直接在浏览器地址栏输入：http://localhost:8080/brochure.pdf
若 PDF 正常显示（或触发下载），说明路径配置成功；若 404，则需重新检查文件物理位置。
遵循此规范，不仅 PDF 可下载，所有静态资源（CSS、JS、图片等）均可统一管理，保障项目结构清晰、部署可靠。
