如何利用Ubuntu进行JSP调试

在 Ubuntu 上调试 JSP 的高效做法

调试 JSP 听起来好像很麻烦，其实只要把环境搭对、工具用好，整个流程就能跑得很顺。下面就把关键步骤拆开来讲，从零开始，一步步落地。

一、环境准备与验证

先把基础环境搭起来。JDK 是必备的，建议用 8、11 或 17 这些长期支持版本。直接跑命令：

sudo apt update && sudo apt install openjdk-11-jdk

安装完记得验证一下：ja va -version 和 ja vac -version，确保版本正确。接着装 Tomcat，这里用 Ubuntu 仓库里的 tomcat9 包，省事：

sudo apt install tomcat9 tomcat9-admin

装好后启动并设置开机自启：

sudo systemctl start tomcat9 && sudo systemctl enable tomcat9

检查服务状态 sudo systemctl status tomcat9，然后浏览器访问 http://localhost:8080，看到欢迎页就说明环境通了。

二、本地调试步骤（Eclipse 或 IntelliJ IDEA）

IDE 是调试的主力，这里以 Eclipse 和 IntelliJ IDEA 为例。

准备项目：Eclipse 下新建 Dynamic Web Project，把 JSP 放到 WebContent 目录；IDEA 的话用 Ma ven 或 Gradle 的 Web 项目，JSP 放在 src/main/webapp 下。然后配置 Tomcat 运行时——Eclipse 里进 Preferences → Server → Runtime Environments，添加 Apache Tomcat v9；IDEA 在 Project Structure → SDKs/Application Servers 里指定 Tomcat 路径。

以调试方式运行：Eclipse 里右键项目 → Debug As → Debug on Server，选择刚才配好的 Tomcat；IDEA 则在 Run/Debug Configurations 新建一个 Tomcat Server → Local，部署应用后点 Debug 按钮。这样 IDE 就会以调试模式启动 Tomcat。

断点与热部署：在 JSP 的 scriptlet、声明、表达式或者关联的 Servlet/Filter/Listener 里设置断点。浏览器访问对应页面，断点触发后 IDE 会进入调试视图，可以看变量、栈、表达式求值。配合热部署（Eclipse 的自动发布或 IDEA 的 HotSwap）能大幅提升迭代效率，不过涉及类结构变更时还是得重启应用。

三、远程调试 Tomcat 进程

有时候需要远程调试，比如在服务器上跑的应用。操作也不复杂。

开启调试端口：编辑 /usr/share/tomcat9/bin/catalina.sh，在文件靠前位置加入两行：

export JPDA_ADDRESS=8000
export JPDA_TRANSPORT=dt_socket

然后重启 Tomcat：sudo systemctl restart tomcat9，这时 Tomcat 会以 JPDA 模式监听 8000 端口。

IDE 附加调试：Eclipse 里选择 Run → Debug Configurations → Remote Ja va Application，Host 填 localhost，Port 8000，选好项目源码后点 Debug。IDEA 则是 Run/Debug Configurations → Remote JVM Debug，同样 Host localhost、Port 8000，配置好模块类路径后 Debug。

之后访问 http://localhost:8080/your-app/page.jsp 触发断点，IDE 就会捕获执行，效果和本地调试一样。

四、日志与常见问题排查

调试过程中免不了遇到各种问题，日志是第一救援手段。

查看日志：实时看用什么？tail -f /var/log/tomcat9/catalina.out。其他日志文件也在 /var/log/tomcat9/ 下，比如 localhost*.log、manager.*.log、host-manager.*.log，按需查看。

常见问题速查：

• 应用没生效：确认已部署到 /var/lib/tomcat9/webapps/，必要时重启 Tomcat（sudo systemctl restart tomcat9）
• 依赖缺失：把需要的 JAR 放进 WEB-INF/lib/
• 权限问题：sudo chown -R tomcat:tomcat /var/lib/tomcat9/webapps/your_app/ 和 sudo chmod -R 755 /var/lib/tomcat9/webapps/your_app/
• 端口占用：检查 8080 或 8000 是否被占用——ss -ltnp | grep -E '8080|8000'，如果被占就调整端口或释放
• 浏览器缓存：用无痕模式或强制刷新（Ctrl+F5）

五、实用建议与工具

最后聊点锦上添花的东西。一套完整的开发工具链能帮你省不少力气：JDK、Apache Tomcat、Eclipse/IntelliJ IDEA、Ma ven/Gradle、Git、MySQL/PostgreSQL、VisualVM/JDB 等等。提前配好，编码和调试效率会明显提升。

另外注意版本兼容：Tomcat 9 建议搭配 JDK 8 或 11，必要时在 IDE 里显式设置 Project SDK 和 Language Level。这些小细节往往就是卡壳的根本原因，提前处理好能省去很多排查时间。