使用SpringBoot打包Jar文件部署到服务器-精创网络云防护

帮助文档
使用SpringBoot打包Jar文件部署到服务器
来源：www.jcwlyf.com更新时间：2025-02-23
在现代的软件开发中，Spring Boot 是一种流行的 Java 框架，它能够帮助开发者快速构建生产级别的应用程序。Spring Boot 提供了非常方便的功能，如自动配置、内嵌式服务器等，使得开发和部署变得更加简单。本文将详细介绍如何使用 Spring Boot 将应用打包成 JAR 文件并部署到服务器，帮助开发者顺利完成部署工作。
在进行 Spring Boot 应用程序的部署时，首先需要打包成 JAR 文件，然后将其上传到目标服务器。JAR 文件的优势在于它包含了应用所需的所有依赖，可以独立运行，不需要在目标服务器上安装其他依赖的环境。接下来，我们将通过一些简单的步骤，详细讲解如何使用 Spring Boot 打包 JAR 文件以及如何部署到服务器。
一、准备工作
在开始之前，确保你已经安装了以下工具：
JDK（推荐使用 JDK 8 或更高版本）
Spring Boot 项目
Apache Maven 或 Gradle（可以选择其中任何一个作为构建工具）
目标服务器（如 Linux 服务器、云服务器等）
在确保环境配置无误之后，我们就可以开始着手打包和部署 Spring Boot 应用了。
二、使用 Maven 打包 Spring Boot 应用
Spring Boot 提供了便捷的打包方式，可以通过 Maven 来完成构建。首先，确保你的 Spring Boot 项目中已经正确配置了 "pom.xml" 文件。以下是一个常见的 Spring Boot 项目的 "pom.xml" 配置示例：
```
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>
```
在 "pom.xml" 文件中， "spring-boot-maven-plugin" 插件是用来将 Spring Boot 应用打包为一个独立可执行的 JAR 文件的关键。配置好之后，我们可以通过 Maven 命令来进行打包操作。
在项目根目录下打开命令行工具，运行以下 Maven 命令进行打包：
```
mvn clean package
```
执行该命令后，Maven 会将项目的所有源代码编译并打包成一个 JAR 文件。生成的 JAR 文件通常位于 "target" 目录下。你可以在命令行中查看是否成功生成了 "your-application-name.jar" 文件。
三、使用 Gradle 打包 Spring Boot 应用
如果你使用的是 Gradle 构建工具，同样也可以轻松实现打包。确保在 "build.gradle" 文件中添加了以下配置：
```
plugins {
    id 'org.springframework.boot' version '2.5.4'
    id 'java'
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    // 其他依赖
}

bootJar {
    baseName = 'your-application-name'
    version = '0.1.0'
}
```
完成配置后，使用 Gradle 命令打包 Spring Boot 应用：
```
gradle build
```
该命令执行后，打包文件将会生成在 "build/libs" 目录下。
四、将 JAR 文件上传到服务器
成功打包 JAR 文件之后，接下来就是将 JAR 文件上传到目标服务器了。如果你使用的是 Linux 服务器，可以通过 "scp" 命令上传文件：
```
scp target/your-application-name.jar user@server-ip:/path/to/deploy/
```
该命令会将 JAR 文件上传到服务器上的指定目录中。替换 "user" 为你服务器的用户名，"server-ip" 为服务器的 IP 地址，"/path/to/deploy/" 为你希望上传文件的目录。
如果你的服务器有其他操作系统，如 Windows，可以使用 WinSCP 等工具来上传文件。
五、在服务器上启动 Spring Boot 应用
上传完 JAR 文件之后，我们可以在服务器上启动 Spring Boot 应用。首先，登录到服务器，并进入 JAR 文件所在的目录。然后执行以下命令来启动应用：
```
java -jar your-application-name.jar
```
该命令会启动 Spring Boot 应用，默认情况下，应用会在 8080 端口启动。你可以通过浏览器访问 "http://your-server-ip:8080" 来查看应用是否正常运行。
如果你希望将应用放到后台运行并保持运行状态，可以使用 "nohup" 命令：
```
nohup java -jar your-application-name.jar > /dev/null 2>&1 &
```
该命令会将应用放到后台并且不受终端关闭的影响。
六、配置 Spring Boot 应用的端口和环境变量
有时，我们需要修改 Spring Boot 应用的端口或配置其他环境变量。在 "application.properties" 或 "application.yml" 中配置端口非常简单。例如：
```
server.port=8081
```
这将把应用的端口修改为 8081。如果你希望通过环境变量来修改配置，可以在启动命令中使用 "-D" 选项传递参数：
```
java -Dserver.port=8081 -jar your-application-name.jar
```
这样启动时应用就会在 8081 端口上运行。
七、设置 Spring Boot 应用为系统服务
为了确保 Spring Boot 应用在服务器重启后仍能自动启动，我们可以将其配置为系统服务。以 Linux 系统为例，可以创建一个 "systemd" 服务文件。
首先，进入 "/etc/systemd/system/" 目录，创建一个新的服务文件：
```
sudo vi /etc/systemd/system/springboot-app.service
```
在服务文件中添加以下内容：
```
[Unit]
Description=Spring Boot Application
After=syslog.target

[Service]
User=your-user
ExecStart=/usr/bin/java -jar /path/to/your-application-name.jar
SuccessExitStatus=143
TimeoutStopSec=10
Restart=always

[Install]
WantedBy=multi-user.target
```
保存并关闭文件后，执行以下命令启动并启用服务：
```
sudo systemctl daemon-reload
sudo systemctl start springboot-app
sudo systemctl enable springboot-app
```
通过这三条命令，你可以启动 Spring Boot 应用并确保它在系统重启后自动启动。
八、总结
通过本文的讲解，我们可以看到，使用 Spring Boot 打包 JAR 文件并部署到服务器是一个简单而高效的过程。首先，我们通过 Maven 或 Gradle 构建工具打包应用，然后上传到服务器并启动。如果需要的话，还可以将应用配置为后台运行或系统服务。希望这篇文章能帮助你顺利完成 Spring Boot 应用的部署。
无论你是初学者还是有经验的开发者，理解这些部署过程对于确保应用的稳定性和可用性至关重要。希望你在开发和部署 Spring Boot 应用时能够游刃有余。