Eclipse创建JSP项目步骤详解

本文深入解析了在 Eclipse 中创建和运行 JSP 项目的常见陷阱与核心要点，直击“为何 Dynamic Web Project 不自动生成 index.jsp”“Tomcat 配置成功却启动失败”“404 页面找不到”“JSP 编译报错”等高频痛点，系统梳理了部署路径、JDK 版本、Web Module 规范（如 Jakarta EE 迁移）、web.xml 配置、依赖冲突及 Eclipse 内部元数据（如 Deployment Assembly 和 facet 版本）等关键影响因素，用实战经验告诉你：JSP 跑不起来，往往不是代码错了，而是环境、配置与约定的细节没对齐——掌握这些，才能真正把项目稳稳跑在 Tomcat 上。

Dynamic Web Project 创建时为啥没看到 JSP 模板？

因为 Eclipse 不会自动为你生成 index.jsp，哪怕你选的是 Dynamic Web Project。它只建好目录结构（WebContent/ 或 src/main/webapp/），JSP 文件得手动加。

常见错误现象：HTTP Status 404 – /myapp/，浏览器打不开，控制台也没报错——大概率是压根没放 index.jsp 进去。

• 新建项目后，右键 WebContent（或 webapp）→ New → JSP File，起名 index.jsp
• 如果用的是 Maven 结构（src/main/webapp），确保 Deployment Assembly 已映射该路径到 /
• 别把 JSP 放进 src/main/java 或 src/main/resources，容器根本不会扫描那里

Tomcat 在 Eclipse 里配好了却启动失败：常见原因

不是“配了就完事”，Eclipse 只负责把项目部署到 Tomcat 的 work 和 webapps 目录，中间任何一环断掉都会静默失败。

典型错误信息：Publishing failed because of a conflict with the server's configuration 或控制台卡在 Starting Servlet engine 不动。

• 检查 Server Locations：右键服务器 → Properties → Server Locations，选 Use Tomcat installation（别用 workspace metadata）
• 确认 Runtime Environment 指向的是你本地解压好的 Tomcat 目录，不是 JRE 路径
• 删掉 Servers 视图里的旧服务器配置再重配，避免残留的 server.xml 冲突
• 如果用 Tomcat 10+，注意 JSP 依赖从 javax.* 切到了 jakarta.*，Eclipse 默认 Dynamic Web Module 版本要 ≥ 5.0 才兼容

运行 JSP 页面提示 “The requested resource is not available”

这通常不是代码问题，而是部署路径和访问路径对不上。Eclipse 把项目发布成一个 context path，你得按这个路径访问。

比如项目名是 myweb，没改过 context root，那正确地址是 http://localhost:8080/myweb/index.jsp，不是 http://localhost:8080/index.jsp。

• 右键项目 → Properties → Web Project Settings → Context root，可改成 / 让它成为默认应用（但同一台 Tomcat 只能有一个）
• 检查 Deployment Assembly 是否把 WebContent（或 webapp）映射到了 /，否则静态资源和 JSP 都找不到
• 如果用了 web.xml 配 welcome-file-list，确保里面写的文件名和实际文件大小写、扩展名完全一致（Index.jsp ≠ index.jsp）

JSP 编译报错 “Unable to compile class for JSP”

本质是 Tomcat 启动时尝试把 JSP 编译成 Servlet 失败，最常踩的坑是类路径或语法环境不匹配。

错误信息里常带 org.apache.jasper.JasperException 和一堆 javac 相关提示。

• 确认项目 Java Build Path 的 Compliance Level 和 Tomcat 使用的 JDK 版本一致（比如 Tomcat 9 要求 JDK 8+，但若设成 Java 17 编译级别，JSP 编译器可能不认）
• 检查 WEB-INF/lib 有没有混入老版本的 jsp-api.jar 或 servlet-api.jar —— Tomcat 自带这些，重复引入会导致冲突
• JSP 里用的 EL 表达式（如 ${user.name}）需要 web.xml 的 schema 支持：Dynamic Web Module 3.0+ 对应 http://xmlns.jcp.org/xml/ns/javaee，别用老的 http://java.sun.com/xml/ns/j2ee

真正麻烦的点往往藏在细节里：比如 Tomcat 9 下跑 web.xml 声明为 2.5 的项目，EL 默认是关闭的，得手动加 false；又比如 Eclipse 自动生成的 .settings/org.eclipse.wst.common.project.facet.core.xml 里 facet 版本和实际不符，也会让 JSP 编译器迷路。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Eclipse创建JSP项目步骤详解》文章吧，也可关注golang学习网公众号了解相关技术文章。