首页手记 Spring Boot应用的生产发布教程：新手入门指南

Spring Boot应用的生产发布教程：新手入门指南

标签：

SpringBoot 运维

概述

本文提供了Spring Boot应用的生产发布教程，从项目搭建、构建打包到配置生产环境和部署监控，帮助开发者轻松入门Spring Boot应用的生产环境部署。文中详细介绍了如何使用Maven或Gradle构建项目，打包成可执行的jar或war文件，并提供了生产环境下的配置方法。此外，还涵盖了在不同容器和云平台上的部署步骤，确保应用的稳定运行。

Spring Boot应用简介

Spring Boot框架概述

Spring Boot 是一个基于Spring框架的脚手架，用于简化新Spring应用的初始搭建和设置过程。它通过提供默认配置和自动配置功能，大大减少了开发人员在配置Spring框架和设置环境时的工作量。Spring Boot使得创建独立、生产级别的基于Spring的应用程序变得更加容易，同时保持了Spring框架的灵活性和可扩展性。

Spring Boot的主要特点和优势

自动配置：Spring Boot 可以自动地为应用提供默认配置，例如数据库连接、视图解析器等。
无需XML配置：Spring Boot 主要使用注解进行配置，基本不需要编写传统的XML配置文件。
嵌入式容器：Spring Boot 可以内置Tomcat、Jetty或Undertow等容器，直接启动一个独立的微服务。
起步依赖：通过提供一系列“起步依赖”，开发者可以快速添加功能模块，例如 spring-boot-starter-web 用于Web开发，spring-boot-starter-data-jpa 用于JPA数据访问等。
命令行接口：Spring Boot 提供了一个强大的命令行工具Spring Boot CLI，用于构建、运行和测试应用。
Actuator监控：Spring Boot Actuator 提供了一系列工具来帮助监控和管理应用，包括端点暴露、健康检查、指标追踪等。

快速搭建Spring Boot项目的步骤

建立项目目录：创建一个文件夹作为项目根目录，并在其中创建 src/main/java 和 src/main/resources 两个子目录。
创建Maven或Gradle项目：使用Maven或Gradle工具创建项目，定义 pom.xml 或 build.gradle 文件。

添加Spring Boot起步依赖：在Maven的 pom.xml 文件或Gradle的 build.gradle 文件中添加Spring Boot的起步依赖。

<!-- Maven pom.xml -->
<dependencies>
   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-web</artifactId>
       <version>2.5.4</version>
   </dependency>
</dependencies>

// Gradle build.gradle
dependencies {
   implementation 'org.springframework.boot:spring-boot-starter-web:2.5.4'
}

编写主类：在 src/main/java 目录下创建一个主类，并使用 @SpringBootApplication 注解标记该类，该注解集成了 @Configuration、@EnableAutoConfiguration 和 @ComponentScan 三个注解。主类中包含一个 main 方法，用于启动应用。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class HelloWorldApplication {
   public static void main(String[] args) {
       SpringApplication.run(HelloWorldApplication.class, args);
   }
}

编写简单的REST API：在对应包下创建一个控制器类，使用 @RestController 标记为控制器，并添加 @RequestMapping 注解定义访问路径。

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class HelloWorldController {

   @GetMapping("/hello")
   public String hello() {
       return "Hello, World!";
   }
}

项目构建与打包

使用Maven或Gradle构建Spring Boot项目

Maven构建Spring Boot项目

配置pom.xml文件：在项目的根目录下创建pom.xml文件，定义项目的Maven配置。

<project xmlns="http://maven.apache.org/POM/4.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.example</groupId>
   <artifactId>hello-world</artifactId>
   <version>0.0.1-SNAPSHOT</version>
   <parent>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-parent</artifactId>
       <version>2.5.4</version>
   </parent>
   <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>
</project>

构建项目：在命令行中执行mvn clean install命令，执行Maven的清理、编译和安装操作。
```
mvn clean install
```

Gradle构建Spring Boot项目

配置build.gradle文件：在项目的根目录下创建build.gradle文件，定义项目的Gradle配置。

plugins {
   id 'org.springframework.boot' version '2.5.4'
   id 'io.spring.dependency-management' version '1.0.11.RELEASE'
   id 'java'
}

repositories {
   mavenCentral()
}

dependencies {
   implementation 'org.springframework.boot:spring-boot-starter-web'
}

task wrapper(type: Wrapper) {
   gradleVersion = '6.8.3'
}

构建项目：在命令行中执行./gradlew build命令，执行Gradle的构建操作。
```
./gradlew build
```

打包Spring Boot应用为可执行的jar或war文件

Maven打包为可执行JAR：Maven会自动将应用打包成一个独立的可执行JAR文件，包含所有依赖和运行所需的资源文件。
```
mvn package
```
Gradle打包为可执行JAR：Gradle同样可以生成独立的可执行JAR文件。
```
./gradlew bootJar
```

打包为WAR文件：如果需要将应用打成WAR文件，可以配置 pom.xml 或 build.gradle 文件中的插件来实现。

<!-- Maven pom.xml -->
<build>
   <plugins>
       <plugin>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-maven-plugin</artifactId>
       </plugin>
       <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-war-plugin</artifactId>
           <version>3.2.3</version>
           <configuration>
               <failOnMissingWebXml>false</failOnMissingWebXml>
           </configuration>
       </plugin>
   </plugins>
</build>

// Gradle build.gradle
plugins {
   id 'org.springframework.boot' version '2.5.4'
   id 'io.spring.dependency-management' version '1.0.11.RELEASE'
   id 'java'
}

dependencies {
   implementation 'org.springframework.boot:spring-boot-starter-web'
}

war {
   classpath += sourceSets.main.runtimeClasspath
}

配置打包时排除测试代码和设置应用的主类

在打包时，可以配置Maven或Gradle排除测试代码，设置应用的主类。

Maven配置排除测试代码和主类：

<build>
   <plugins>
       <plugin>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-maven-plugin</artifactId>
           <configuration>
               <mainClass>com.example.HelloWorldApplication</mainClass>
               <includes>
                   <include>!**/*Test.class</include>
               </includes>
           </configuration>
       </plugin>
   </plugins>
</build>

Gradle配置排除测试代码和主类：

springBoot {
   mainClass = 'com.example.HelloWorldApplication'
   exclusions = ['**/*Test.class']
}

配置生产环境

设置Spring Boot的配置文件（application.properties/application.yml）

Spring Boot使用 application.properties 或 application.yml 文件来加载配置。生产环境的配置通常包括数据库连接、服务器端口、线程池大小等。

使用 application.properties：

server.port=8080
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=password

使用 application.yml：

server:
 port: 8080
spring:
 datasource:
   url: jdbc:mysql://localhost:3306/mydb
   username: root
   password: password

环境变量和配置文件的使用

可以通过环境变量覆盖配置文件中的属性。例如，可以设置环境变量 SPRING_DATASOURCE_URL 来覆盖 application.properties 或 application.yml 中的数据库URL。

export SPRING_DATASOURCE_URL=jdbc:mysql://production-db.example.com:3306/mydb

配置日志和监控

Spring Boot提供了强大的日志配置功能。可以通过 application.properties 或 application.yml 文件配置日志级别和输出位置。

配置日志级别：

logging.level.root=INFO
logging.level.com.example=DEBUG

配置文件位置：

logging.file.name=logs/application.log
logging.file.max-size=10MB
logging.file.max-history=10

使用Spring Boot Actuator监控应用

Spring Boot Actuator提供了多个端点来监控应用的状态，如 /actuator/health 用于健康检查， /actuator/metrics 用于收集指标等。

开启Actuator功能：

在 pom.xml 或 build.gradle 文件中添加Actuator依赖。

<!-- Maven pom.xml -->
<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

// Gradle build.gradle
implementation 'org.springframework.boot:spring-boot-starter-actuator'

访问Actuator端点：

访问 /actuator/health 端点查看应用的健康状态。

部署Spring Boot应用

在Tomcat、Jetty或Undertow上部署Spring Boot应用

Spring Boot应用可以选择在Tomcat、Jetty或Undertow容器中运行。

在Tomcat容器中运行：

java -jar myApplication.jar --server.port=8080

在Jetty容器中运行：

java -jar myApplication.jar --server.port=8080 --server.tomcat.connector.protocol=org.eclipse.jetty.http.HttpChannel

在Undertow容器中运行：

java -jar myApplication.jar --server.port=8080 --server.undertow.io-threads=4

使用Docker容器化部署Spring Boot应用

创建Dockerfile：

FROM openjdk:8-jre-alpine
VOLUME /tmp
ARG JAR_FILE
COPY ${JAR_FILE} myApplication.jar
EXPOSE 8080
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/myApplication.jar"]

构建Docker镜像：
```
docker build -t my-application .
```

运行Docker容器：

docker run -p 8080:8080 -e SPRING_DATASOURCE_URL=jdbc:mysql://localhost:3306/mydb my-application

在云平台（如AWS、Azure）上部署Spring Boot应用

在AWS EC2实例上部署：
- 登录EC2实例
- 拷贝Spring Boot应用的JAR文件到EC2实例
- 使用 java -jar 命令启动应用
```
java -jar myApplication.jar --server.port=8080
```
在Azure App Service上部署：
- 使用Azure CLI或Azure门户上传JAR文件
- 配置应用设置和环境变量

应用监控与调优

使用Actuator监控Spring Boot应用

Spring Boot Actuator提供了多个端点来监控应用的状态，如 /actuator/health 用于健康检查， /actuator/metrics 用于收集指标等。

开启Actuator功能：

在 pom.xml 或 build.gradle 文件中添加Actuator依赖。

<!-- Maven pom.xml -->
<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

// Gradle build.gradle
implementation 'org.springframework.boot:spring-boot-starter-actuator'

访问Actuator端点：

访问 /actuator/health 端点查看应用的健康状态。

性能调优和优化建议

线程池配置：调整线程池大小以匹配应用的负载。

spring:
 application:
   name: my-app
 jpa:
   properties:
     hibernate:
       temp:
         use_java_io: false

连接池配置：优化数据库连接池配置。

spring:
 datasource:
   hikaricp:
     minimum-idle: 5
     maximum-pool-size: 20
     connection-timeout: 30000

常见问题排查和解决方法

内存溢出：增加JVM堆内存。

java -Xms512M -Xmx1024M -jar myApplication.jar

启动缓慢：检查应用的启动日志，识别可能的瓶颈。

应用更新与维护

更新应用版本和依赖项

更新应用版本：

修改 pom.xml 或 build.gradle 文件中的版本号。

<!-- Maven pom.xml -->
<version>1.0.0</version>

// Gradle build.gradle
version = '1.0.0'

更新依赖项：

修改 pom.xml 或 build.gradle 文件中的依赖版本。

<!-- Maven pom.xml -->
<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-web</artifactId>
   <version>2.5.4</version>
</dependency>

// Gradle build.gradle
implementation 'org.springframework.boot:spring-boot-starter-web:2.5.4'

实现热更新（可选）

使用Spring Boot DevTools：

在 pom.xml 或 build.gradle 文件中添加DevTools依赖。

<!-- Maven pom.xml -->
<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-devtools</artifactId>
   <scope>runtime</scope>
</dependency>

// Gradle build.gradle
implementation 'org.springframework.boot:spring-boot-devtools'

日常维护和备份策略

定期备份：备份应用的源代码和数据库数据。
监控日志：定期检查应用日志，识别潜在的问题。
漏洞扫描：定期扫描应用和依赖项的漏洞。
性能监控：持续监控应用的性能指标，确保应用的稳定运行。

点击查看更多内容

为 TA 点赞

若觉得本文不错，就分享一下吧！

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

慕神8447489

手记
篇

粉丝

174

获赞与收藏

957

关注作者，订阅最新文章

阅读免费教程

后端通用面试教程

41个小节 30583 343

网络编程入门教程

20个小节 12561 237

Pandas 入门教程

25个小节 18499 337

推荐

评论

收藏

共同学习，写下你的评论



感谢您的支持，我会继续努力的～

扫码打赏，你说多少就多少

赞赏金额会直接到老师账户

支付方式

打开微信扫一扫，即可进行扫码打赏哦

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

恭喜你，你的运气太好了，居然抽中了 100个积分！

恭喜你，抽中了价值元的专栏！

太棒了，直接落到你账户里！

积分商城里的罗技鼠标、机械键盘、
Kindle 阅读器、小米平衡车
Apple iPad （10.2英寸）、大额优惠券
在等着你去兑换了噢

作者：

免费赠送

兑换码：1111222211 复制

优惠券可用于购买实战课、体系课
无门槛使用

先去看看，有什么好东西马上兑换我爱学习，选课去


热搜

最近搜索清空