通过jar包将springboot后端代码部署到服务器

关于使用jar包部署springboot后端代码的过程整理记录.

一、本地开发阶段

1. 项目配置
   • 技术栈确认：Spring Boot + Maven + Java 8/11。
   • 关键文件：
   ◦ pom.xml：管理依赖和打包插件。
   ◦ application.yml：配置端口、数据库连接、日志路径等。
2. 打包前检查
   • 端口配置：

server:
  port: 9099
  address: 0.0.0.0  # 允许外部访问

3. 生成可执行 JAR
   • 打包命令：
   mvn clean package
   • 生成文件：
   ◦ target/myapp-0.0.1-SNAPSHOT.jar：可执行 Fat JAR。
   

---

二、服务器准备阶段

1. 基础环境配置
   • 连接服务器(或直接使用finalshell连接)：
   ssh ubuntu@118.89.xxx.xxx
   • 安装 Java：
   Ubuntu 安装 OpenJDK 8 , 与项目java版本一致
   sudo apt update
sudo apt install openjdk-8-jdk
   • 验证版本：
   java -version # 输出应含 "1.8.0", 与项目版本一致
2. 目录与权限
   • 创建目录：
   sudo mkdir -p /opt/myapp # 存放 JAR 文件
3. 上传 JAR 文件
   • 本地传输到服务器：
   此处我直接使用final shell将jar包进行拖入, 也可以使用如下命令进行jar包的上传
   scp -P 22 target/myapp-0.0.1-SNAPSHOT.jar ubuntu@118.89.xxx.xxx:/opt/myapp/ #将jar包放入服务器的/opt/myapp文件下
   

---

三、服务部署阶段

1. 启动应用
   • 简单启动（测试）：
   cd /opt/myapp # 进入jar包的目录
java -jar myapp-0.0.1-SNAPSHOT.jar # 启动测试
   • 后台启动（生产）：
   nohup java -jar myapp-0.0.1-SNAPSHOT.jar > /var/log/myapp/console.log 2>&1 &

---

四、网络与安全配置

1. 防火墙放行端口
   • Ubuntu (ufw)：
   sudo ufw allow 9099/tcp
sudo ufw reload
2. 云服务器安全组
   • 操作步骤：
   a. 登录云服务商控制台（如腾讯云、阿里云）。
   b. 找到服务器关联的安全组，添加入站规则：
   ▪ 协议：TCP
   ▪ 端口：9099
   ▪ 来源：0.0.0.0/0（允许所有 IP 访问）。

五、服务验证

1. 基础检查
   • 进程状态：
   ps aux | grep java
   • 端口监听：
   sudo netstat -tulnp | grep :9099
2. 接口测试
   • 服务器内部测试：
   curl http://localhost:9099/XTian/
   • 外部访问测试：
   本地机器执行
   curl http://118.89.xxx.xxx:9099/XTian/
   • 使用postman测试
   

---

六、维护与优化

1. 服务管理命令
   • 常用 systemd 命令：

sudo systemctl status myapp   # 查看状态
sudo systemctl restart myapp  # 重启服务
sudo journalctl -u myapp      # 查看完整日志

---

七、完整部署流程图

本地开发 → 打包 JAR → 上传服务器 → 安装环境 → 启动服务 → 配置网络 → 验证访问—

八、常见问题速查表

问题
排查命令/操作

端口未监听
netstat -tulnp | grep :9099

服务未启动
systemctl status myapp

权限不足
chmod 755 /var/log/myapp

502 Bad Gateway
curl -v http://localhost:9099/XTian/

依赖缺失
mvn dependency:tree

---