eclipse 创建 dynamic web project 不自动生成 index.jsp,需手动在 webcontent 或 webapp 下新建;部署路径、jdk 版本、web.xml 版本及依赖冲突是 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 默认是关闭的,得手动加 <el-ignored>false</el-ignored>;又比如 Eclipse 自动生成的 .settings/org.eclipse.wst.common.project.facet.core.xml 里 facet 版本和实际不符,也会让 JSP 编译器迷路。










