CentOS JSP项目部署步骤

在CentOS上部署JSP项目，其实是个标准流程，尤其在Ja va Web开发中几乎是基本功。很多新手会卡在环境配置和Tomcat的细节上，今天就把这些步骤拆开揉碎，把容易踩坑的地方提前点出来。下面从零开始，一步步来。

1. 安装Ja va环境JSP

JSP的运行离不开Ja va运行时环境（JRE/JDK），推荐用OpenJDK 1.8或更高版本，稳定且兼容性好。

# 检查是否已安装Ja va
yum list installed | grep ja va
# 安装OpenJDK 1.8（含开发工具包）
sudo yum install -y ja va-1.8.0-openjdk-devel
# 验证安装（需显示Ja va版本信息）
ja va -version
# 配置环境变量（可选，若未自动配置）
echo 'export JA VA_HOME=/usr/lib/jvm/ja va-1.8.0-openjdk' >> /etc/profile
echo 'export PATH=$JA VA_HOME/bin:$PATH' >> /etc/profile
source /etc/profile

搞定这一步，系统就有了编译和运行JSP的基础环境。

2. 安装与配置Tomcat

Tomcat是JSP的事实标准容器，下面有两种安装方式，根据你的使用场景选一个就行。

方式一：Yum快速安装（简单省事）

sudo yum install -y tomcat tomcat-webapps tomcat-admin-webapps
sudo systemctl start tomcat
sudo systemctl enable tomcat   # 设置开机自启

方式二：手动下载安装（灵活，推荐最新版）

# 下载Tomcat（以9.0.56为例）
wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.56/bin/apache-tomcat-9.0.56.tar.gz
# 解压到/opt目录
sudo tar -zxvf apache-tomcat-9.0.56.tar.gz -C /opt/
sudo mv /opt/apache-tomcat-9.0.56 /opt/tomcat
# 配置环境变量
echo 'export CATALINA_HOME=/opt/tomcat' >> /etc/profile
echo 'export PATH=$CATALINA_HOME/bin:$PATH' >> /etc/profile
source /etc/profile
# 启动Tomcat
/opt/tomcat/bin/startup.sh
sudo systemctl enable tomcat

无论哪种方式，安装完成后建议配置Tomcat管理用户，方便通过Web管理界面操作。编辑 /opt/tomcat/conf/tomcat-users.xml，添加管理员账号：

然后重启Tomcat让配置生效：/opt/tomcat/bin/shutdown.sh && /opt/tomcat/bin/startup.sh。

3. 部署JSP项目

部署的核心是把项目打包成WAR文件，然后放到Tomcat的自动部署目录里。

打包项目（使用Ma ven）

如果你的项目是用Ma ven管理的，在项目根目录执行下面的命令即可：

mvn clean package

生成的WAR文件位于 target/ 目录下，比如 my-jsp-project.war。

手动部署

将WAR文件复制到Tomcat的 webapps/ 目录。注意路径差异——Yum安装的路径是 /usr/share/tomcat/webapps/，手动安装的是 /opt/tomcat/webapps/：

sudo cp target/my-jsp-project.war /opt/tomcat/webapps/

Tomcat会自动识别并解压WAR文件，生成同名文件夹，不需要手动干预。

4. 验证部署

启动Tomcat后，在浏览器里访问项目URL：

http://your_server_ip:8080/your_project_name

假如WAR文件名是 my-jsp-project.war，访问地址就是 http://your_server_ip:8080/my-jsp-project。如果能看到项目首页（比如JSP测试页面），说明部署成功，大功告成。

5. 常见问题解决

• 端口冲突：Tomcat启动失败时，先检查8080端口是否被占用（netstat -tulnp | grep 8080）。如果被占用，修改 /opt/tomcat/conf/server.xml 中的 为其他端口，比如8081。
• 权限问题：确保Tomcat用户（如 tomcat）对 webapps/、logs/ 等目录有读写权限。用这条命令搞定：sudo chown -R tomcat:tomcat /opt/tomcat/。
• JSP乱码：在JSP页面顶部添加 <%@ page contentType="text/html;charset=UTF-8" language="ja va" %>，或者在 server.xml 的 里加上 URIEncoding="UTF-8"。两种方法任选其一。

6. 可选优化步骤

• 配置防火墙：如果系统启用了firewalld，需要开放8080端口：

sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
sudo firewall-cmd --reload

• 设置Tomcat开机自启：如果之前没有通过systemd配置过，可以手动创建服务文件 /etc/systemd/system/tomcat.service（网上可以找到现成模板），然后执行 sudo systemctl daemon-reload 和 sudo systemctl enable tomcat。这样重启机器后Tomcat会自动启动。