Debian JSP开发环境搭建步骤

一 安装与验证 Java JDK

• 更新索引并安装 OpenJDK（推荐 OpenJDK 11 或 17）：
  • sudo apt update
  • sudo apt install openjdk-11-jdk # 或 openjdk-17-jdk
• 验证安装：
  • java -version
  • javac -version
• 说明：使用包管理器安装便于依赖与后续升级维护。

二 安装与配置 Apache Tomcat

• 方式 A（推荐，系统服务管理）：安装 Tomcat 9 及管理组件
  • sudo apt update
  • sudo apt install tomcat9 tomcat9-admin
  • sudo systemctl start tomcat9
  • sudo systemctl enable tomcat9
  • 访问测试：打开浏览器进入 http://服务器IP:8080
• 方式 B（手动安装，便于多版本并存与自定义）：
  • 下载并解压（示例为 Tomcat 9.0.56）：
    • wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.56/bin/apache-tomcat-9.0.56.tar.gz
    • sudo tar -xvf apache-tomcat-9.0.56.tar.gz -C /opt
    • sudo ln -s /opt/apache-tomcat-9.0.56 /opt/tomcat
  • 创建专用用户与权限：
    • sudo groupadd tomcat
    • sudo useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat
    • sudo chown -R tomcat:tomcat /opt/tomcat
    • sudo chmod +x /opt/tomcat/bin/*.sh
  • 创建 systemd 服务（/etc/systemd/system/tomcat.service）：
    • [Unit]
      • Description=Apache Tomcat Web Application Container
      • After=network.target
    • [Service]
      • Type=forking
      • User=tomcat
      • Group=tomcat
      • Environment=JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
      • Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pid
      • Environment=CATALINA_HOME=/opt/tomcat
      • Environment=CATALINA_BASE=/opt/tomcat
      • Environment=‘CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC’
      • Environment=‘JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom’
      • ExecStart=/opt/tomcat/bin/startup.sh
      • ExecStop=/opt/tomcat/bin/shutdown.sh
      • Restart=always
      • RestartSec=10
    • [Install]
      • WantedBy=multi-user.target
  • 启动与开机自启：
    • sudo systemctl daemon-reload
    • sudo systemctl start tomcat
    • sudo systemctl enable tomcat
• 访问测试：浏览器进入 http://服务器IP:8080。

三 配置环境变量

• 设置 JAVA_HOME（系统级，所有用户生效）：
  • 编辑 /etc/environment，添加（路径以实际为准）：
    • JAVA_HOME=“/usr/lib/jvm/java-11-openjdk-amd64”
  • 使配置生效：
    • source /etc/environment
    • echo $JAVA_HOME
• 如使用手动版 Tomcat，可同时设置 CATALINA_HOME（可选，很多场景下不设置也可运行）：
  • 在 /etc/environment 添加：
    • CATALINA_HOME=“/opt/tomcat”
  • 使配置生效并重启 Tomcat：
    • source /etc/environment
    • sudo systemctl restart tomcat
• 说明：也可在 ~/.bashrc 或 /etc/profile 中导出变量，但系统级文件更利于服务与脚本使用。

四 部署与验证 JSP 应用

• 快速验证（在 ROOT 下放置测试页）：
  • echo ‘<%@ page contentType=“text/html;charset=UTF-8” language=“java” %>

    Hello, JSP!

    ’ | sudo tee /opt/tomcat/webapps/ROOT/index.jsp
  • 访问：http://服务器IP:8080/index.jsp
• 部署 WAR 应用：
  • 将应用打包为 your-app.war，复制到 webapps：
    • sudo cp your-app.war /opt/tomcat/webapps/
  • Tomcat 会自动解压并部署，访问：http://服务器IP:8080/your-app
• 管理控制台（可选，便于部署与监控）：
  • 如需使用 /manager/html，在 Tomcat 用户配置（如 /etc/tomcat9/tomcat-users.xml）中添加具有 manager-gui 角色的用户后再登录。

五 常见问题与优化

• 端口与防火墙：
  • 默认 HTTP 端口为 8080；如需修改，编辑 server.xml 的 。
  • 开放防火墙端口（UFW 示例）：sudo ufw allow 8080/tcp
• 多版本 JDK 切换：
  • 使用 update-alternatives 管理默认 java/javac：
    • sudo update-alternatives --config java
    • sudo update-alternatives --config javac
• 性能与稳定性（在 systemd 服务或 setenv.sh 中调整）：
  • 常见参数：JAVA_OPTS 增加 -Djava.awt.headless=true；CATALINA_OPTS 设置堆内存如 -Xms512M -Xmx1024M 并选择合适的 GC。
• 日志与问题排查：
  • 查看实时日志：tail -f /opt/tomcat/logs/catalina.out
  • 检查端口占用：ss -tlnp | grep 8080
• 安全建议：
  • 禁止以 root 运行 Tomcat；为管理界面设置强口令并限制可访问来源。