Eclipse创建JSP项目教程及运行方法

本文详细讲解了在Eclipse中创建、配置和调试JSP项目的完整流程，重点破解新手常踩的四大陷阱：必须正确配置Target Runtime（如Tomcat v9.0）才能生成WebContent目录；JSP文件必须严格置于WebContent或其子目录下，否则部署即404；调试时断点需设在容器编译生成的*_jsp.java文件中而非原始JSP里；修改后无响应往往源于Eclipse未自动发布或浏览器缓存作祟——每一步都直击痛点，并附带可立即操作的解决方案与避坑提示，助你高效搭建并稳定运行JSP应用。

新建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 中加 <% System.out.println("break here"); %> 配合控制台日志快速定位逻辑流

修改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。

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