Eclipse创建JSP项目及Tomcat配置教程

本文详细解析了在Eclipse中创建JSP项目及配置Tomcat时最易踩坑的核心问题：从Dynamic Web Project不会自动生成index.jsp、手动创建与路径映射的关键操作，到Tomcat部署失败、404资源不可用、JSP编译报错等典型故障的深层原因与精准排查方法——涵盖Server Locations设置、JDK版本与编译级别匹配、Jakarta EE迁移适配、web.xml版本与EL支持、依赖冲突规避等实战细节，帮你绕过静默失败陷阱，真正实现JSP项目一键运行。

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项目及Tomcat配置教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！