SpringBoot项目部署到宝塔面板的详细过程

旺仔nai糖

已于 2025-03-15 16:23:24 修改

阅读量3.6k

点赞数 30

CC 4.0 BY-SA版权

分类专栏：项目部署文章标签： spring boot 后端 java

于 2025-03-15 16:21:31 首次发布

本文链接：https://blog.csdn.net/qq_73427280/article/details/146280389

项目部署专栏收录该内容

3 篇文章

订阅专栏

前言

本次以SmartAdmin项目为例，通过宝塔面板部署，对部署过程进行一个完整演示，不同项目的部署也可能略有不同

准备工具：可正常登录宝塔面板、SpringBoot项目（本文以SmartAdmin的开源项目为例）、Navicat Premium 17（或者其他数据库管理软件，亦或者是数据库的SQL脚本）、IntelliJ IDEA 2024.2.3。

本项的部署以测试环境为例，涉及到配置相关的，可以根据自己的项目按需修改即可。上传流程建议按照文档流程，先上传数据库再上传后端，最后在上传前端和移动端。本文主要介绍如何上传后端项目。

本文使用到的项目为SmartAdmin的开源项目，用户可在此基础上添加自己的各种Api或者前端页面，项目地址：SmartAdmin | 1024创新实验室

项目的部署总体来说分为三步，第一步是上传数据库；第二步是对项目在本地进行必要的修改，并打包上传；第三步是在服务器启动项目。本文就是围绕上述步骤进行的，部署的环境为test环境，实际过程可参考下文，对于不同项目的部署，每一小节之后都会有具体说明：

一、上传数据库

1、SQL脚本的获取

如果本身就有SQL脚本，可忽略这一步。

以Navicat为例，不同软件操作方式可能不完全一样。首先打开Navicat，找到项目对应的数据库smart_admin_v3,右键点击数据库，然后转存为SQL文件，注意需要选择转存结构和数据。

然后选择一个本地路径保存即可。

2、上传数据库

首先在宝塔面板新建数据库，设置名称和密码（与后文对应即可），这里名称设置为了smart_admin_v3，密码设置成了123456。输入数据库名之后，用户名默认自动输入，与数据库名保持一致。

建好之后点击管理跳转到phpMyAdmin数据库管理页面。

或者点击phpMyAdmin均可访问。

在点击新建的smart_admin_v3架构，点击SQL，把我们刚才转存的SQL文件的内容手动复制进来。可以通过记事本或者其他的IDE打开第一步转存的SQL文件，全选，然后复制到phpMyAdmin页面。

然后ctrl+A选中所有SQL语句，点击执行即可。

二、项目的修改与打包

项目的修改主要是修改一些项目配置，最重要的是数据库地址。smartAdmin项目使用了.env文件进行环境管理，这里我们只需要修改运行环境，并且修改相应运行环境的配置文件即可。如果你的项目没有.env文件或者你部署之后就完事了，不用考虑运维的话，也可以直接修改当前文件的配置文件。

1、修改后端配置

找到sa-base目录下的resourc目录，本项目使用测试环境，故再打开test目录内yaml文件，这里主要修改数据库连接信息。

数据库地址可以选择本地（127.0.0.1），因为服务器的数据库和后端项目是在同一个服务器。下面数据库用户名和密码修改为上一章新建的数据库的用户名和密码即可。

其他配置可能也需要修改，但是那些配置不影响部署，这里暂时忽略。

既然都已经到部署这一步了，想必大家都已经知道如何在本地启动项目，如何修改数据库的配置了。不清楚的可以看这篇文章

快速在本地运行SpringBoot项目的流程介绍_怎么运行springboot项目-CSDN博客

上面介绍的主要是修改数据库配置，不同项目目录结构可能不太相同。可以使用搜索功能搜索jdbc就可以找到数据库配置的位置了。

2、打包后端项目

Smart admin官网文档给的打包指令如下：

开发环境：mvn clean package -Dmaven.test.skip=true -P dev

测试环境：mvn clean package -Dmaven.test.skip=true -P test

预发布环境：mvn clean package -Dmaven.test.skip=true -P pre

生产环境：mvn clean package -Dmaven.test.skip=true -P prod

实际在黑框运行时mvn clean package -Dmaven.test.skip=true -P test指令时会报错。这里选择手动修改pom文件更改环境，关闭测试，然后使用它的生命周期进行打包：

找到根目录下的pom文件，最下面定义了运行环境，其中有

字样的代码，默认给了dev环境，这里把他剪切到test标签下，如下图。

记得刷新maven！而且记得打包之后把这个配置再改回来！改完之后务必再刷新一遍Maven！

然后点击IEDE右侧的maven，禁用测试，先执行一遍clean，在执行package。

这时就可以在sa-admin的target目录下，找到一个以.jar结尾的jar包，这个jar包就是我们打包好的jar包。

将此jar包上传到宝塔面板，这里上传的目录是/home/smart_admin_v3/2025.3.10目录下：

如果你的项目不需要修改运行环境，可以直接执行声明周期里跳过测试（可选）、clean、package。

三、启动项目

1、添加java项目

打开网站，选择java项目，添加java项目，目录选择刚才上传的jar包，勾选放行端口（如果没有勾选，后续也可在安全内手动放行），改一下项目名字（可选），选一下jdk版本（本项目使用的1.8，如果没有你项目需要的jdk，可以在宝塔面板自行下载）后启动项目

多切换几下页面等待一会儿，当显示放行的端口时即启动成功。

2、设置域名

找到刚才的启动的项目后方有一个设置，点击设置

为此项目添加一个域名，需要注意域名格式。这里添加的是test.zh-online.tech，域名需要在服务器解析之后才能正常使用，我们服务器使用的是腾讯云，因此就需要在腾讯云解析此域名。需要记住这个域名，后面前端项目和移动端项目要用到。

四、总结

相比之下后端部署还是比较简单的。部署时先上传数据库，在上传后端项目。后端项目打包之前需要修改配置文件，最关键的是修改数据库相关的配置，其他的配置按需修改。最后就是部署了，部署时域名需要在服务器解析域名（本文未介绍）才可正常使用。

关于前端部署可以看：