SpringBoot 项目启动和部署总结

古城微笑少年丶 2022-05-19 11:43 210阅读 0赞

默认情况下，SpringBoot 内置 Tomcat，可以直接在 Java IDE 中启动，也可以打成 jar 包，用 `java -jar` 命令启动。但是，如果要用外部 Tomcat 管理多个项目，就要打成 war 包。本文以 Maven 项目为例，总结了 SpringBoot 各种部署方法和相关事项。为便于演示，我使用的环境是 Windows，而 Linux 下方法大同小异。  
  
**作者：**王克锋  
**出处：**[https://kefeng.wang/2017/12/18/spring-boot-deploy/][https_kefeng.wang_2017_12_18_spring-boot-deploy]  
**版权：**[自由转载-非商用-非衍生-保持署名][-_-_-]，转载请标明作者和出处。

## 1 新建项目 spring-boot ##

SpringBoot 项目创建方法参考文章 [Spring Boot 开发概要][Spring Boot]

### 1.1 pom.xml ###

<packaging>jar</packaging>
    
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

### 1.2 application.properties ###

spring.main.banner-mode=off
    logging.level.org.springframework=INFO
    logging.pattern.console=%d{HH:mm:ss.SSS}  %p  [%F:%L] - %m%n
    
    server.port=8080

### 1.3 HelloController.java ###

@RestController
    public class HelloController { 
        @RequestMapping("/hello")
        public String hello() {
            return "hello! " + System.currentTimeMillis();
        }
    }

### 1.4 HelloApplication.java ###

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

## 2 使用内置容器启动 ##

默认为自带 Tomcat 容器(spring-boot-starter-web 中依赖了 spring-boot-starter-tomcat)；  
默认打包为 jar 格式，可以像普通应用程序一样启动。

### 1.1 Java IDE 中启动 ###

IntelliJ IDEA 中，打开应用类文件(HelloApplication.java)直接运行其中的 main() 即可；  
浏览器访问: [http://localhost:8080/hello][http_localhost_8080_hello]

### 1.2 操作系统命令行中启动 ###

call mvn.cmd -Dmaven.test.skip=true package
    java -jar target\spring-boot-0.0.1-SNAPSHOT.jar

浏览器访问: [http://localhost:8080/hello][http_localhost_8080_hello]

### 1.3 部署为服务(CentOS 环境) ###

参考文章 [Tomcat 安装及其单机多实例部署][Tomcat]  
官方资料: [Installing Spring Boot applications][]  
借助于服务管理器 systemd，可以部署为单实例或多实例。  
之后可以优雅地启动和停止服务，避免暴力 kill。

## 3 部署于外部 Tomcat 容器 ##

官方参考资料：  
[Spring Boot Reference Guide][]  
[Traditional deployment][]

### 3.1 修改 pom.xml ###

打包方式由 jar 调整为 war；  
注意：默认依赖的 spring-boot-starter-tomcat 无需排除，生成的 war 包不但可以部署到外部 Tomcat，还可以像之前一样使用 `java -jar` 启动。

### 3.2 调整 HelloApplication.java ###

应用类继承 SpringBootServletInitializer 并重写 configure() 方法。

@SpringBootApplication
    public class HelloApplication extends SpringBootServletInitializer { 
        @Override
        protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
            return application.sources(HelloApplication.class);
        }
    
        public static void main(String[] args) {
            SpringApplication.run(HelloApplication.class, args);
        }
    }

### 3.3 修改 Tomcat 配置 server.xml ###

修改为自动解压(unpackWARs=”true”)，自动部署(autoDeploy=”true”)。

### 3.4 部署脚本 mk.cmd ###

改用侯捷老师的名言，脚本面前无秘密。脚本简单解释如下：  
打为 war 包，删除 Tomcat 目录下的项目原目录，复制 war 包，启动 Tomcat。

call mvn.cmd -Dmaven.test.skip=true package
    
    rd /s/q "%CATALINA_HOME%\webapps\spring-boot"
    copy /y "target\spring-boot-0.0.1-SNAPSHOT.war" "%CATALINA_HOME%\webapps\spring-boot.war"
    call "%CATALINA_HOME%\bin\startup.bat"

### 3.5 查看效果 ###

浏览器访问: [http://localhost:8080/spring-boot/hello][http_localhost_8080_spring-boot_hello]  
注意 URL 多了个项目名(spring-boot)，原因是 Tomcat 需要管理多个项目，解压出的项目多了一层目录名。

## 4 更多改进 ##

### 4.1 替换 Tomcat 为 Jetty ###

只需把 pom.xml 中的 spring-boot-starter-tomcat 排除掉，并增加 spring-boot-starter-jetty。

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <exclusions>
                <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-tomcat</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jetty</artifactId>
        </dependency>
    <dependencies>

### 4.2 使用 Profile 区分环境 ###

可用来区分开发环境、测试环境、生产环境等。

#### 4.2.1 各 Bean 声明 @Profile(“xxx”) ####

当当前激活的 profile 与 xxx 一致时，相应的 bean 才会实例化。

@Service
    @Profile("dev")
    class MyServiceDev implements MyService {
    }
    
    @Service
    @Profile("test")
    class MyServiceTest implements MyService {
    }
    
    @Service
    @Profile("prod")
    class MyServiceProd implements MyService {
    }

#### 4.2.2 指定当前激活的 profile ####

*  方法一: `application.properties` 中指定 `spring.profiles.active=xxx`
 *  方法二: 命令行参数中指定 `java -jar spring-boot.jar --spring.profiles.active=xxx`

## 5 热部署 ##

参考文档：[Developer tools][]  
所谓热部署，是指每次修改代码后，无需手动重启，修改即可生效。其原理为：  
(1) Java 文件修改后，IDEA 自动编译为新的 class 文件；  
(2) DevTools 监视到 class 文件有更新，就新建 ClassLoader 加载新的 class，然后把 ClassLoader 由旧切换至新。

### 5.1 添加依赖包 ###

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <optional>true</optional>
    </dependency>

### 5.2 相关配置 ###

修改文件 application.properties：

## 如果使用了 Thymeleaf 模板
    ## 缓存机制，在开发调试阶段禁用(false)，上线后要启用(true)
    spring.thymeleaf.cache=false
    
    ## 为避免服务反复频繁重启，禁用
    ## 效果：静态资源文件会实时更新，但 class 文件需要手工重启服务
    spring.devtools.restart.enabled=false

### 5.3 启用自动构建 ###

注意：DEBUG/RUN 状态下不会自动构建，空闲时才自动构建。

*  进入菜单：File / Settings
 *  展开分支：Build, Execution, Deployment / Compiler
 *  勾上选项：Build project automatically

### 5.4 启用自动编译 ###

注意：无论是否 DEBUG/RUN 状态，都会触发自动构建。

*  按快捷键 Ctrl + Shift + Alt + /，弹出菜单中选择 Registry
 *  找到并勾选 compiler.automake.allow.when.app.running

[https_kefeng.wang_2017_12_18_spring-boot-deploy]: https://kefeng.wang/2017/12/18/spring-boot-deploy/
[-_-_-]: https://creativecommons.org/licenses/by-nc-nd/3.0/deed.zh
[Spring Boot]: https://kefeng.wang/2017/12/16/spring-boot/
[http_localhost_8080_hello]: http://localhost:8080/hello
[Tomcat]: https://kefeng.wang/2016/12/26/tomcat-installation/
[Installing Spring Boot applications]: https://docs.spring.io/spring-boot/docs/current/reference/html/deployment-install.html
[Spring Boot Reference Guide]: https://docs.spring.io/spring-boot/docs/current/reference/html/
[Traditional deployment]: https://docs.spring.io/spring-boot/docs/current/reference/html/howto-traditional-deployment.html
[http_localhost_8080_spring-boot_hello]: http://localhost:8080/spring-boot/hello
[Developer tools]: https://docs.spring.io/spring-boot/docs/current/reference/html/using-boot-devtools.html