如何在Ubuntu上安装JSP环境

在 Ubuntu 上搭建 JSP 环境的推荐做法

使用 OpenJDK 作为 Java 运行时，配合 Apache Tomcat 作为 Servlet/JSP 容器即可快速运行 JSP 应用。下面给出两种常用方式（手动安装与 APT 安装），并包含环境变量、端口、防火墙与常见问题处理，适合本地开发或云服务器部署。

一准备与安装 Java

更新索引并安装 JDK（推荐 OpenJDK 11 或 OpenJDK 17 LTS）
- 安装 OpenJDK 11
  - 命令：sudo apt update && sudo apt install openjdk-11-jdk
- 安装 OpenJDK 17
  - 命令：sudo apt update && sudo apt install openjdk-17-jdk
验证安装
- 命令：java -version、javac -version
多版本管理（可选）
- 查看/切换：sudo update-alternatives --config java、sudo update-alternatives --config javac
设置环境变量（两种方式二选一）
- 全局（系统范围）：编辑 /etc/environment，添加 JAVA_HOME，例如：JAVA_HOME=“/usr/lib/jvm/java-11-openjdk-amd64”，执行 source /etc/environment 生效
- 当前用户：编辑 ~/.bashrc，添加
  - export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
  - export PATH=$JAVA_HOME/bin:$PATH
  - 执行 source ~/.bashrc 生效说明：OpenJDK 可通过 APT 安装、版本切换与环境变量配置，步骤简洁可靠。

二安装 Tomcat 运行 JSP

三部署与验证第一个 JSP

快速验证
- 在 Tomcat webapps 根目录创建测试页
  - 命令：echo ‘<%@ page contentType=“text/html;charset=UTF-8” %>
    Hello JSP on Ubuntu
    ’ | sudo tee /opt/tomcat/webapps/ROOT/hello.jsp
- 访问：http://服务器IP:8080/hello.jsp
部署 WAR
- 将项目打包为 your-app.war，放入 webapps/（手动安装为 /opt/tomcat/webapps；APT 安装为 /var/lib/tomcat9/webapps），Tomcat 会自动解压并部署，访问：http://服务器IP:8080/your-app。

四防火墙与远程访问

UFW（Ubuntu 常用防火墙）
- 开放 8080（HTTP）与 8443（HTTPS，若启用）：sudo ufw allow 8080/tcp；sudo ufw allow 8443/tcp；sudo ufw enable
云服务器安全组
- 在控制台放行 TCP 8080（及 8443）入站规则，确保外网可访问说明：开放端口或放行安全组后，外部浏览器才能访问 Tomcat 页面与应用。

五常见问题与排查

端口被占用
- 检查：ss -tlnp | grep 8080
- 解决：修改 conf/server.xml 中为未占用端口（如 8081），重启 Tomcat
访问被拒绝或无法连接
- 核对云服务器安全组/本机防火墙是否放行 8080；查看 logs/catalina.out 启动日志
多 Java 版本导致不一致
- 使用 sudo update-alternatives --config java 统一默认版本，确保 JAVA_HOME 指向期望的 /usr/lib/jvm/java-xx-openjdk-amd64
管理界面无法登录
- 检查 /etc/tomcat9/tomcat-users.xml 中是否配置了 manager-gui 角色与用户，并重启 Tomcat 说明：Tomcat 的日志与端口配置是首要排查点；管理界面需正确配置用户与角色。

Hello JSP on Ubuntu