
# SpringBoot 项目部署到底在干什么？一文看懂宝塔运维全流程
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/8edfc5c148211e345123bf2b2e81c9df.png)

## 前言

在实际开发中，很多同学都能在本地顺利跑起一个 SpringBoot 项目，但一到服务器部署阶段就开始踩坑：
数据库连不上、端口访问不到、jar 包启动失败、域名配置错误……这些问题往往不是代码问题，而是运维层面的问题。

本文以 **SmartAdmin 开源项目** 为例，完整演示一次从「数据库初始化 → 后端配置修改 → 项目打包 → 宝塔部署 → 域名访问」的全过程，目标是让你不仅“能部署成功”，还要“知道每一步在干什么”。

环境说明：

* 服务器管理面板：宝塔面板
* 后端项目：SpringBoot（SmartAdmin）
* 数据库工具：Navicat Premium 17（或任意数据库工具）
* 开发工具：IntelliJ IDEA 2024.2.3
* 部署环境：test（测试环境）

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/985e24f1636ed95d2a6d842bfbd51802.png)


## 一、部署整体流程说明

从运维视角来看，一个标准的 SpringBoot 项目上线流程，本质上就是三步：

1. **数据库准备好（结构 + 数据）**
2. **后端项目配置正确并打成 jar 包**
3. **服务器启动项目并对外暴露访问方式**

顺序非常重要：

> 一定是 **先数据库 → 再后端 → 最后前端/移动端**。

因为后端一启动就会连数据库，如果数据库不存在或配置错误，项目直接启动失败。
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/38b1394b483cb2e4638c971da503416d.png)

---

安装宝塔面板直接官方脚本即可

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/2a2ead9aeee6e4a60d68f6abb6dbe2eb.png)
安装完成后，确保：

>Nginx 正常运行
80 / 443 已放行
能正常创建站点

## 二、数据库初始化（从本地到服务器）

### 1. 导出本地 SQL 脚本

如果你拿到的是一个完整开源项目，一般作者都会提供 SQL 文件；
如果没有，那就需要从你本地数据库中导出。

以 Navicat 为例：

在本地找到项目数据库 `smart_admin_v3`，右键 → 转储 SQL 文件，记得勾选：

* 结构
* 数据

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/b6eca9235f79ddf8bf2033a8ca9a89d0.png)


导出后的 SQL 文件，本质就是一堆 `CREATE TABLE` + `INSERT` 语句。

---

### 2. 在宝塔中创建数据库

进入宝塔面板 → 数据库 → 新建数据库：

* 数据库名：smart_admin_v3
* 用户名：默认同名
* 密码：自定义（比如 123456）

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/ef131888b800d7600db3f049595172c5.png)



创建完成后点击「管理」，进入 phpMyAdmin：

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/0862e2fe436159783b07a5251cc787db.png)


或者直接点击 phpMyAdmin：

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/eb784c7cdbc55b54796c7fb5ef033e59.png)


---

### 3. 导入 SQL 数据

选择刚建的数据库 → SQL → 把本地 SQL 文件内容复制进来：

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/86d70fd8c4caab7f5a3a11d58c0d52ee.png)


执行：

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/37d32a295cc10644021515b99c71ffba.png)


如果没有报错，说明数据库初始化成功。

从这一刻开始，服务器上已经具备了“后端运行所需的数据基础”。

---

## 三、后端配置修改（最核心的一步）

绝大多数部署失败，本质都是这里出问题。

### 1. 找到数据库配置文件

SmartAdmin 使用 `.env + 多环境配置` 的方式管理环境。

路径大致为：

```
sa-base/src/main/resources/test/application-test.yml
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/53fa4149ff8aec7b9ece2b6a9fd7fbc8.png)


重点关注数据库连接部分：

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/397e8e9a332a9f6e82a4c7db00621ff8.png)


关键字段解释：

```yaml
url: jdbc:mysql://127.0.0.1:3306/smart_admin_v3
username: smart_admin_v3
password: 123456
```

这里的逻辑是：

* `127.0.0.1`：因为数据库和项目在同一台服务器
* `3306`：MySQL 默认端口
* 数据库名、用户名、密码必须和宝塔中创建的一致

---

### 2. 一个重要认知：部署 = 修改配置 + 打包

部署从来不是“上传 jar 就完事”，而是：

> 你必须保证 jar 包里打进去的配置，本身就是服务器环境的配置。

很多人犯的错误是：

* 本地连的是 localhost
* 服务器数据库是另外一个地址
* 结果 jar 一上传，项目直接启动报错

---

## 四、后端项目打包

### 1. 关于多环境打包的坑

官方推荐命令：

```bash
mvn clean package -Dmaven.test.skip=true -P test
```

但在实际项目中，经常会遇到：

* profile 不生效
* maven 插件冲突
* 构建报奇怪错误

一种更稳定、可控的方法是：**直接在 pom.xml 中切换默认环境**。

在 `pom.xml` 中找到：

```xml
<activation>
    <activeByDefault>true</activeByDefault>
</activation>
```

把它从 `dev` 移动到 `test`：

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/cd4762481b22ef3714d254de8fae47c1.png)


然后：

1. 刷新 Maven
2. 禁用测试
3. 执行 clean
4. 执行 package

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/262df9f3b936360f60b58d847a9501fd.png)


---

### 2. 获取 jar 包

打包成功后，在：

```
sa-admin/target/
```

目录下即可看到 jar：

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/5a60dff2ae563d4c08da5d1ac3168c48.png)


---

## 五、上传 jar 到服务器

在宝塔文件管理中，新建目录：

```
/home/smart_admin_v3/2025.3.10/
```

上传 jar：

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/b4785a7e695f73cf90f6587aae5bb79e.png)


这个目录结构本身就是一种“运维习惯”：

* 项目名
* 按日期区分版本
* 方便回滚

---

## 六、宝塔启动 Java 项目

### 1. 添加 Java 项目

宝塔 → 网站 → Java 项目 → 添加：

* 选择 jar 路径
* 勾选放行端口
* 选择 JDK（比如 1.8）

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/8a8420bfc8b706b7aadfc6fe3af8d9fa.png)


等待几秒，如果看到端口出现：

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/b436e4d4877c389a6fb9216f5517d74e.png)


说明 JVM 已经启动成功。

本质上，宝塔帮你做的事情就是：

```bash
java -jar xxx.jar
```

只是包装成了一个可视化界面。

---

### 2. 配置域名访问

点击项目 → 设置 → 添加域名：


例如：

```
xx.xx
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/11e8ab73b910f6f543a9c2d016741f48.png)


注意一个关键点：

> 域名必须在云厂商（腾讯云 / 阿里云 / 华为云）完成 DNS 解析，指向这台服务器 IP，否则无法访问。

---

## 七、从运维视角理解整个过程

如果我们站在更高一层来看，这个部署流程本质是：

### 1. 数据层

* MySQL 提供持久化能力
* SQL 决定系统初始状态

### 2. 应用层

* SpringBoot jar 是业务核心
* 所有配置在打包前就必须确定

### 3. 网络层

* 端口决定是否能访问
* 域名决定访问方式是否友好

宝塔的价值在于：

* 把 Linux 命令行运维，变成可视化流程
* 降低后端工程师的运维门槛
* 非专业运维也能完成完整部署

---

## 八、常见部署踩坑总结

真实线上最容易翻车的点：

### 1. 数据库连不上

* 用户名/密码写错
* 数据库名不一致
* 防火墙没开端口

### 2. jar 启动失败

* JDK 版本不匹配
* 配置文件没打进去
* profile 环境错误

### 3. 域名访问不了

* DNS 未解析
* 宝塔未绑定域名
* 端口未放行

---

## 九、总结

相比前端部署，SpringBoot 后端部署的技术难度并不高，真正难的是：

> 你是否具备“系统级视角”，理解一套服务是如何从代码变成线上系统的。

通过这次 SmartAdmin 的完整部署流程，可以抽象出一个通用模型：

**数据库准备 → 修改配置 → 打包构建 → 服务器启动 → 域名访问**

一旦你掌握了这套模型：

* 换项目，只是换 jar
* 换服务器，只是换 IP
* 换环境，只是换配置

这也是后端工程师从“写代码的人”，走向“能交付系统的人”的关键一步。

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10730009/483d1bf951dd94b442284ac15e7f63c2.png)


总体来看，SpringBoot 项目的部署本质上并不是“把代码传到服务器”这么简单，而是一个完整的工程化交付过程：数据库决定系统的数据基础，配置文件决定运行环境，jar 包承载业务逻辑，而服务器与域名则负责对外服务能力。宝塔面板的价值在于将原本分散在 Linux 命令行中的运维操作高度集成和可视化，使后端开发者可以以更低成本完成从开发到上线的闭环。真正成熟的部署能力，不在于记住某几个命令，而在于理解每一步背后的系统结构和运行原理，一旦建立起这种整体认知，无论更换项目、环境还是服务器，本质流程都是可复用的。

在实际开发中，很多同学都能在本地顺利跑起一个 SpringBoot 项目，但一到服务器部署阶段就开始踩坑：数据库连不上、端口访问不到、jar 包启动失败、域名配置错误……这些问题往往不是代码问题，而是运维层面的问题。

SpringBoot 项目部署到底在干什么？一文看懂宝塔面板运维全流程

运维

后端

网络与通信

宝塔面板环境下部署x-ui并实现网站共存的完整指南，涵盖反向代理配置、BBR加速优化、WARP网络增强等实用技巧。通过Nginx反向代理实现服务隔离，避免端口冲突，提升安全性。详细讲解安装流程、节点配置及常见问题解决方案，帮助用户高效利用服务器资源，打造稳定安全的代理环境。

数据库

服务器

防火墙

MySQL

Linux

Java

2026新春采购季

tencentdb-catalog

4核4G3M云服务器 新用户低至38元/年！

domain

腾讯云数据库特惠，新用户首单0.5折起


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

SpringBoot 项目部署到底在干什么？一文看懂宝塔面板运维全流程-腾讯云开发者社区-腾讯云

SpringBoot 项目部署到底在干什么？一文看懂宝塔面板运维全流程

SpringBoot 项目部署到底在干什么？一文看懂宝塔面板运维全流程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐