附录 - A5. 初始化数据库 - 《后端技术知识库》

上手体验
配置详解
应用建议

Spring Boot 当前的最新版本是 2.6.0。自 2.5.0开始，Spring Boot 启用了全新的配置方式，调整了Datasource 的初始化机制。

具体的，我们可以从这个类org.springframework.boot.autoconfigure.sql.init.SqlInitializationProperties里看到详情。下面我们通过一个简单的例子来体验这个功能的作用。

上手体验

创建一个Spring Boot的基础应用，并在pom.xml中引入和MySQL（或MariaDB）的依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

在配置文件中增加数据源和初始化数据源的配置，具体如下：

spring.datasource.url=jdbc:mysql:****
spring.datasource.username=****
spring.datasource.password=****
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# Spring Boot 2.5.0 init schema & data
# 执行初始化脚本的用户名称
spring.sql.init.username=root
# 执行初始化脚本的用户密码
spring.sql.init.password=
# 初始化的schema脚本位置
spring.sql.init.schema-locations=classpath*:schema-all.sql

根据上面配置的定义，接下来就在resource目录下，创建脚本文件schema-all.sql，并写入一些初始化表结构的脚本

create table test.user_info
(
    id          int unsigned auto_increment comment '用户id'
        primary key,
    open_id     varchar(255)     default '' null comment '微信小程序openid',
    nick_name   varchar(255)     default '' null comment '微信名',
    head_img    varchar(255)     default '' null comment '微信头像',
    sex         varchar(255)     default '' null comment '性别',
    phone       varchar(255)     default '' null comment '手机',
    province    varchar(255)     default '' null comment '注册地址：省',
    city        varchar(255)     default '' null comment '注册地址：城市',
    country     varchar(255)     default '' null comment '注册地址：县/区',
    status      tinyint unsigned default 0  not null comment '是否标记删除 0：否 1：是',
    create_time datetime                    not null comment '创建时间',
    update_time datetime                    not null comment '更新时间'
)
comment '用户表';

完成上面步骤之后，启动应用。然后打开MySQL客户端，可以看到在test库下，多了一个user_info表。

通过上面的例子，不难想到这样的功能主要可以用来管理应用启动与数据库配置的自动执行，以减少应用部署过程中手工执行的内容，降低应用部署的执行步骤。

配置详解

除了上面用到的配置属性之外，还有一些其他的配置，下面详细讲解一下作用。

spring.sql.init.enabled
是否启动初始化的开关，默认是true。如果不想执行初始化脚本，设置为false即可。通过-D的命令行参数会更容易控制。
spring.sql.init.username和spring.sql.init.password
配置执行初始化脚本的用户名与密码。这个非常有必要，因为安全管理要求，通常给业务应用分配的用户对一些建表删表等命令没有权限。这样就可以与datasource中的用户分开管理。
spring.sql.init.schema-locations
配置与schema变更相关的sql脚本，可配置多个（默认用;分割）。
spring.sql.init.data-locations
用来配置与数据相关的sql脚本，可配置多个（默认用;分割）。
spring.sql.init.encoding
配置脚本文件的编码。
spring.sql.init.separator
配置多个sql文件的分隔符，默认是分号（;）。
spring.sql.init.continue-on-error
如果执行脚本过程中碰到错误是否继续，默认是false`；所以，上面的例子第二次执行的时候会报错并启动失败，因为第一次执行的时候表已经存在。
应用建议
关于这些配置的应用，相信一定会把它与数据库的版本管理联系起来（因为可以自动的执行脚本）。那么依靠这些配置，是否可以胜任业务应用部署时候数据库初始化的自动化实现呢？

就上述所介绍的配置，虽然具备了一定的自动执行能力。但由于缺失对当前环境的判断能力，所以要应对实际的部署场景来说，还是远远不够的。

如果要自动化的管理数据库表结构、初始化数据的话，建议是：默认提供的这个初始化功能可以考虑仅用于测试，自动创建数据库结构与初始化数据，使用完毕后销毁。可以方便的控制每次测试的执行环境一致。

应用在环境部署的时候，还是要使用类似 Flyway 这样的工具来实现，具体的可以参见：使用Flyway来管理数据库版本。

联合Flyway一同使用，通过org.springframework.jdbc.datasource.init.DataSourceInitializer，能够定义更复杂的执行逻辑。

A5. 初始化数据库

上手体验

配置详解

应用建议