新建Dynamic Web Project时必须选对Target Runtime,即配置Tomcat服务器(如v9.0),否则不生成WebContent目录导致JSP无法部署;JSP文件须置于WebContent或其子目录下;调试需在编译后的*_jsp.java中设断点;修改后需确保自动发布生效并禁用浏览器缓存。

新建Dynamic Web Project时必须选对Target Runtime
直接点 New → Dynamic Web Project,但关键在 Target runtime 下拉框。如果没配过服务器,这里会是空或只有“None”——此时不能跳过,必须先配置 Tomcat(比如 Apache Tomcat v9.0)。否则项目创建后连 WebContent 文件夹都不会生成,后续所有 JSP 都无法部署。
常见错误现象:The project cannot be built until build path errors are resolved 或右键 Run on Server 时提示 No servers available。
- 打开
Window → Preferences → Server → Runtime Environments,点击 Add 添加已下载的 Tomcat 根目录 - 新建项目时,在
Target runtime中选中刚添加的 Tomcat 版本 - 勾选
Generate web.xml deployment descriptor(尤其对初学者友好,避免手动写配置)
JSP 文件必须放在 WebContent 或其子目录下
Eclipse 不识别 src 或 Java Resources 下的 .jsp 文件——它们不会被发布到服务器,访问时直接 404。
正确路径示例:WebContent/index.jsp、WebContent/pages/login.jsp。若放错位置,即使语法无误,Run on Server 后浏览器打开 http://localhost:8080/yourproject/index.jsp 也会报错。
- 右键项目 →
New → JSP File,向导默认路径即为WebContent,可直接确认 - 手动拖拽 .jsp 文件进项目时,务必拖到
WebContent节点内,不是项目根目录 - 如果用了 Maven 结构,需确保
src/main/webapp被识别为 Deployment Assembly 源路径(右键项目 →Properties → Deployment Assembly检查)
调试JSP时断点要打在生成的Java文件里才有效
JSP 实际运行的是容器编译后的 Servlet(如 index_jsp.java),源码级断点打在 .jsp 文件上看似高亮,但常不触发——因为 Eclipse 默认没把临时编译目录加入调试源路径。
典型表现:F8 单步跳过 JSP 中的 Java 代码段,或断点显示 “unavailable”,控制台却输出了预期结果。
- 启动服务器时用 Debug 模式(右键服务器 →
Debug,而非 Run) - 首次访问 JSP 后,在
Workspaces/.metadata/.plugins/org.eclipse.wst.server.core/tmp0/work/Catalina/localhost/yourproject/org/apache/jsp/下找到对应*_jsp.java文件 - 在该 .java 文件的 Java 代码行打断点(例如
out.println("hello");前),才能真正停住 - 更稳妥做法:在 JSP 中加
配合控制台日志快速定位逻辑流
修改JSP后刷新浏览器没反应?检查自动发布和缓存
很多人改完 JSP 点保存,刷新浏览器却还是旧内容——问题通常不在代码,而在两个地方:Eclipse 是否启用自动发布,以及浏览器是否缓存了响应。
错误现象:Ctrl+S 保存后,浏览器 F5 刷新仍显示老文本;或者服务器控制台没打印任何 JSP 修改后的 System.out 日志。
- 确认 Servers 视图中 Tomcat 状态栏显示
Publishing...后变成Synchronized;若一直是Republish黄色图标,右键它 →Publish - 关闭浏览器缓存:开发者工具(F12)→ Network → 勾选
Disable cache;或用 Ctrl+F5 强制刷新 - 极少数情况需清空 Tomcat 工作目录:
Right-click server → Clean…,再重启
最易被忽略的一点:JSP 修改后,如果页面里有 EL 表达式或 JSTL 标签且未正确引入 taglib,可能静默失败——此时浏览器空白,控制台却无报错,得看 Tomcat 的 catalina.out 日志才能发现 org.apache.jasper.JasperException。










