Ubuntu服务器上JSP如何进行故障排查

Ubuntu 服务器上 JSP 故障排查清单

一 快速定位流程

• 确认 Java 环境：执行 java -version、javac -version，推荐安装 openjdk-11-jdk。
• 确认 Tomcat 状态：执行 sudo systemctl status tomcat9，未运行则 sudo systemctl start tomcat9。
• 验证应用是否部署：查看 /var/lib/tomcat9/webapps/ 是否包含你的应用目录或 ROOT.war。
• 实时查看日志：执行 tail -f /var/log/tomcat9/catalina.out，优先从日志定位错误。
• 访问验证：浏览器或命令行访问 http://服务器IP:8080/应用名/页面.jsp；本机可用 curl 测试。
• 修改后重启：必要时执行 sudo systemctl restart tomcat9 使配置与类生效。

二 环境与组件检查

• Java 版本与兼容性：确保 JDK 已安装且与项目兼容（如 Java 8/11），不一致会导致编译或运行异常。
• Tomcat 安装与端口：安装 tomcat9（可选 tomcat9-admin），检查 /etc/tomcat9/server.xml 中 是否被占用或改动。
• 部署路径与方式：
  • 目录部署：将应用放入 /var/lib/tomcat9/webapps/your_app/；
  • WAR 部署：将 app.war 放入同一目录，Tomcat 会自动解压。
• 文件权限：确保 Tomcat 运行用户对应用目录有访问权限，例如 sudo chown -R tomcat9:tomcat9 /var/lib/tomcat9/webapps/your_app。

三 日志与常见错误定位

• 日志位置与命令：
  • 控制台日志：/var/log/tomcat9/catalina.out（最常用）；
  • 应用日志：在应用目录 WEB-INF/classes/ 或配置的 logs/ 下；
  • 访问日志：默认在 /var/log/tomcat9/localhost_access_log.*.txt。
• 常见错误与处理：

四 部署与权限修复

• 正确的部署路径：
  • 将 JSP 放入 /var/lib/tomcat9/webapps/your_app/；
  • 或部署 ROOT.war 映射到根路径 /；
  • 访问示例：http://服务器IP:8080/your_app/index.jsp。
• 权限与属主：
  • 建议将应用目录属主设为 tomcat9:tomcat9，如 sudo chown -R tomcat9:tomcat9 /var/lib/tomcat9/webapps/your_app；
  • 目录权限 755、文件 644 更稳妥。
• 依赖管理：
  • 第三方 JAR 统一放入 WEB-INF/lib/；
  • 使用 Maven/Gradle 管理依赖并重新打包部署。
• 重启生效：配置、依赖或类更新后执行 sudo systemctl restart tomcat9。

五 进阶调试与优化

• 远程与本地调试：
  • 在 IDE（如 IntelliJ IDEA/Eclipse）中配置 Remote Debug 连接到 Tomcat，断点定位后端逻辑；
  • 使用 jdb、VisualVM 等工具分析线程、内存与类加载。
• 自定义错误页面：在 web.xml 配置全局错误页，便于线上问题收集与展示。
• 编码与国际化：统一使用 UTF-8，JSP 页面与响应头保持一致。
• 连接池与数据库：核对 JDBC URL、驱动版本、连接池参数，确保数据库可达与账号权限正确。
• 运维建议：保持 系统与软件包更新（sudo apt update && sudo apt upgrade），定期归档与清理 catalina.out，必要时使用 logrotate。