1179 字

3 分钟

Ubuntu 24.04 上机考试 JSP项目完整部署文档

2026-05-30

技术

Ubuntu

/

JSP

/

Tomcat

/

MySQL

/

Java环境部署

/

JDK更换

/

SMBMS

Ubuntu 24.04 JSP项目完整部署文档#

一、任务#

安装 Ubuntu 24.04 服务器版虚拟机(默认已安装)
通过 tar压缩包 安装 JDK 1.8（或按需更换其他 JDK 版本）
通过 tar压缩包 安装 Tomcat 8.x
通过 apt命令 安装 MySQL 8.0
完成 SMBMS 动态JSP项目完整部署并浏览器访问

二、基础环境初始化#

2.1 系统简介#

操作系统：Ubuntu 24.04 Server
统一安装根目录：/home/wmx/java

2.2 更新系统与安装工具#

1
# 更新软件源
2
sudo apt update
3
# 安装必备工具（编辑器、防火墙）
4
sudo apt install nano ufw -y

三、任务一：tar包安装 JDK 1.8 / 更换 JDK 版本#

3.1 创建安装目录#

1
mkdir -p /home/wmx/java
2
cd /home/wmx/java

3.2 解压JDK压缩包#

将提前准备的 JDK 压缩包（如 jdk\-8uxxx\-linux\-x64\.tar\.gz 或新版本的 JDK 压缩包）上传至 /home/wmx/java 目录，执行解压命令：

1
# 以解压 jdk1.8 为例
2
tar -zxvf jdk-8uxxx-linux-x64.tar.gz

3.3 配置或更换用户环境变量#

1
sudo nano ~/.bashrc #或使用vi编辑器

在文件末尾追加或修改现有的 JAVA\_HOME 配置：

1
# ======= JDK Environment =======
2
# 如果需要更换 JDK 版本，直接将下方的路径修改为新解压的 JDK 文件夹绝对路径即可
3
export JAVA_HOME=/home/wmx/java/jdk1.8.0_xxx
4
export PATH=$JAVA_HOME/bin:$PATH

提示：使用nano 编辑时，快捷键保存为 Ctrl\+O → 回车确认 → Ctrl\+X 退出。

3.4 生效变量并验证#

1
# 加载环境变量
2
source ~/.bashrc
3
# 验证Java版本
4
java -version

出现对应的 Java 版本信息即为安装或更换成功。

注意（更换 JDK 后的核心操作）：如果更换了系统的 JDK 版本，必须重启 Tomcat 才能让 Web 项目在新 JDK 环境下运行：

shutdown.sh startup.sh

四、任务二：tar包安装 Tomcat 8.5#

4.1 解压Tomcat压缩包#

将Tomcat8.x压缩包上传至 /home/wmx/java 目录，执行解压：

1
cd /home/wmx/java
2
tar -zxvf apache-tomcat-8.5.99.tar.gz

4.2 授权权限#

1
chmod -R 755 /home/wmx/java/apache-tomcat-8.5.99

4.3 防火墙放行8080端口#

1
sudo ufw allow 8080/tcp
2
sudo ufw reload

4.4 启停命令#

1
cd /home/wmx/java/apache-tomcat-8.5.99/bin
2

3
# 启动
4
./startup.sh
5

6
# 停止
7
./shutdown.sh
8

9
# 查看运行日志
10
tail -f ../logs/catalina.out

4.5 验证#

使用hostname查看本机ip

1
hostname -I

浏览器访问：http://虚拟机IP:8080，出现 Tomcat 小猫主页即为成功。

4.6 常见报错及解决方案#

报错现象：外部浏览器无法访问8080端口
排查原因：Ubuntu防火墙未放行8080端口，端口外部访问权限被拦截

解决命令：

1
sudo ufw allow 8080/tcp
2
sudo ufw reload

报错现象：访问项目页面提示404
排查方向：访问URL尾部必须严格携带项目后缀 /smbms；
检查Tomcat是否自动解压smbms.war部署包；
重启Tomcat服务，解决缓存加载异常问题。

五、任务三：apt安装 MySQL 8.0#

5.1 在线安装MySQL服务#

1
sudo apt install mysql-server -y

5.2 修改登录认证#

Ubuntu 默认 root 用户仅支持系统免密登录，需改为密码登录以适配 Java 项目：

1
sudo mysql

进入 MySQL 终端后，执行以下 SQL 语句：

1
USE mysql;
2
-- 设置root密码为1234，适配JDBC连接
3
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '1234';
4
FLUSH PRIVILEGES;
5
exit;

5.3 验证密码登录#

1
mysql -u root -p

输入密码 1234，可正常进入数据库即为配置完成。

5.4 MySQL常用命令#

1
sudo systemctl start mysql    # 启动
2
sudo systemctl stop mysql     # 停止
3
sudo systemctl restart mysql  # 重启
4
systemctl status mysql        # 查看运行状态

5.5 常见报错及解决方案#

5.5.1 MySQL安装卡死/反复重启#

现象：执行systemctl status mysql显示一直启动中或闪退，日志报错：Failed to find valid data directory、Data Dictionary initialization failed。
原因：安装中断、权限不足或卸载残留，导致/var/lib/mysql数据字典损坏、初始化失败。
修复方案:

1.彻底清理MySQL残留文件

1
sudo systemctl stop mysql
2
sudo systemctl kill -s KILL mysql
3
sudo rm -rf /etc/mysql /var/lib/mysql /var/log/mysql /var/run/mysqld
4
sudo rm -rf /usr/lib/systemd/system/mysql*
5
sudo rm -rf /var/lib/dpkg/info/mysql*

2. 修复包管理器，清理残留安装包

1
# 修复并移除 MySQL 相关包
2
sudo apt -f remove mysql-server mysql-server-8.0 mysql-common -y
3
# 清理 dpkg 可用包缓存
4
sudo dpkg --clear-avails
5
# 自动移除依赖并彻底清除配置
6
sudo apt autoremove --purge -y
7
# 清理本地 apt 缓存
8
sudo apt clean

3. 重装MySQL服务

1
sudo apt update
2
sudo apt install mysql-server -y

5.5.2 无法连接sock文件#

现象：执行 sudo mysql 提示 Can’t connect to local MySQL server through socket ‘/tmp/mysql.sock’
原因：服务端套接字默认路径与客户端寻找路径不匹配。

解决方案：建立软链接映射路径

1
sudo ln -s /run/mysqld/mysqld.sock /tmp/mysql.sock

5.5.3 1045登录拒绝#

原因：已修改root认证模式，禁止系统免密登录。
解决方案：使用密码模式登录数据库：mysql -u root -p，输入密码1234即可。

六、任务四：部署 SMBMS JSP项目#

6.1 项目文件准备#

准备两份文件并上传至服务器 /home/wmx 目录：

smbms.war：项目部署包
smbms.sql：数据库脚本文件

6.2 导入项目数据库#

1
mysql -u root -p

输入密码后，在数据库终端中执行：

1
-- 创建项目数据库
2
CREATE DATABASE IF NOT EXISTS db_smbms DEFAULT CHARACTER SET utf8mb4;
3
USE db_smbms;
4

5
-- 导入数据表脚本
6
SOURCE /home/wmx/smbms.sql;
7

8
-- 查看数据表确认是否导入成功
9
SHOW TABLES;
10
exit;

6.3 部署WAR包至Tomcat#

将 war 包移动至 tomcat 自动部署目录：

1
cp /home/wmx/smbms.war /home/wmx/java/apache-tomcat-8.5.99/webapps/

Tomcat 会自动解压 war 包，并生成 smbms 项目文件夹。

6.4 修改数据库连接配置#

进入项目配置目录，编辑 database.properties：

1
cd /home/wmx/java/apache-tomcat-8.5.99/webapps/smbms/WEB-INF/classes
2
nano database.properties

清空原有内容，粘贴统一配置：

1
driver=com.mysql.cj.jdbc.Driver
2
url=jdbc:mysql://localhost:3306/db_smbms?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true
3
user=root
4
password=1234

6.5 校验驱动包#

进入 lib 目录确认存在 mysql\-connector\-java\-8\.x 驱动包：

1
cd ../lib
2
ls

6.6 重启Tomcat生效#

1
cd /home/wmx/java/apache-tomcat-8.5.99/bin
2
./shutdown.sh
3
./startup.sh

6.7 最终访问项目#

浏览器输入地址：

1
http://虚拟机IP:8080/smbms

成功打开登录页面、可正常登录系统，代表全部考试任务完成。

6.8 项目部署常见报错#

报错类型：Java程序连接数据库失败
排查：核对数据库名称，必须为 db_smbms；
核对数据库账号密码，固定为 root / 1234；
检查 database.properties 的URL，必须携带时区、禁用SSL等完整参数；
校验项目 WEB-INF/lib 目录下，是否存在MySQL8.x驱动Jar包。

Ubuntu 24.04 上机考试 JSP项目完整部署文档

http://www.linyuan0512.top/posts/ubuntu-2404-上机考试-jsp项目完整部署文档/

作者

林远

发布于

2026-05-30

许可协议

Unlicensed

部分信息可能已经过时

Mac 系统部署人人权限管理系统（renren-security）

IP地址分类课堂笔记