新建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 默认没把临时编译目录加入调试源路径。