Spring Boot 2.x基礎教程：2.5版本後資料腳本初始化的變動

前幾天 Spring Boot 2.5.0 釋出了，其中提到了關于Datasource初始化機制的調整，有讀者私信想了解這方面做了什麼調整。那麼今天就要詳細說說這個重新設計的配置内容，并結合實際情況說說我的了解和實踐建議。

https://blog.didispace.com/spring-boot-learning-25-3-13/#%E5%BC%83%E7%94%A8%E5%86%85%E5%AE%B9 棄用内容

先來糾正一個誤區。主要之前在版本更新介紹的時候，存在一些表述上的問題。導緻部分讀者認為這次的更新是Datasource本身初始化的調整，但其實并不是。這次重新設計的隻是對Datasource腳本初始化機制的重新設計。

先來看看這次被棄用部分的内容（位于

org.springframework.boot.autoconfigure.jdbc.DataSourceProperties

），如果你有用過這些配置内容，那麼新配置就很容易了解了。

/**
 * Mode to apply when determining if DataSource initialization should be performed
 * using the available DDL and DML scripts.
 */
@Deprecated
private DataSourceInitializationMode initializationMode = DataSourceInitializationMode.EMBEDDED;

/**
 * Platform to use in the DDL or DML scripts (such as schema-${platform}.sql or
 * data-${platform}.sql).
 */
@Deprecated
private String platform = "all";

/**
 * Schema (DDL) script resource references.
 */
private List<String> schema;

/**
 * Username of the database to execute DDL scripts (if different).
 */
@Deprecated
private String schemaUsername;

/**
 * Password of the database to execute DDL scripts (if different).
 */
@Deprecated
private String schemaPassword;

/**
 * Data (DML) script resource references.
 */
@Deprecated
private List<String> data;

/**
 * Username of the database to execute DML scripts (if different).
 */
@Deprecated
private String dataUsername;

/**
 * Password of the database to execute DML scripts (if different).
 */
@Deprecated
private String dataPassword;

/**
 * Whether to stop if an error occurs while initializing the database.
 */
@Deprecated
private boolean continueOnError = false;

/**
 * Statement separator in SQL initialization scripts.
 */
@Deprecated
private String separator = ";";

/**
 * SQL scripts encoding.
 */
@Deprecated
private Charset sqlScriptEncoding;      

對應到配置檔案裡的屬性如下（這裡僅列出部分，就不全部列出了，主要就是對應上面源碼中的屬性）：

spring.datasource.schema=
spring.datasource.schema-username=
spring.datasource.schema-password=
...      

這些配置主要用來指定資料源初始化之後要用什麼使用者、去執行哪些腳本、遇到錯誤是否繼續等功能。

https://blog.didispace.com/spring-boot-learning-25-3-13/#%E6%96%B0%E7%9A%84%E8%AE%BE%E8%AE%A1 新的設計

Spring Boot 2.5.0開始，啟用了全新的配置方式，我們可以從這個類

org.springframework.boot.autoconfigure.sql.init.SqlInitializationProperties

裡看到詳情。

下面我們通過一個簡單的例子來體驗這個功能的作用。

• 建立一個Spring Boot的基礎應用，并在pom.xml中引入和mysql的依賴：

<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://localhost:3306/test
spring.datasource.username=root
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

  表

通過上面的例子，不難想到這樣的功能主要可以用來管理應用啟動與資料庫配置的自動執行，以減少應用部署過程中手工執行的内容，降低應用部署的執行步驟。

https://blog.didispace.com/spring-boot-learning-25-3-13/#%E9%85%8D%E7%BD%AE%E8%AF%A6%E8%A7%A3 配置詳解

除了上面用到的配置屬性之外，還有一些其他的配置，下面詳細講解一下作用。

• 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`；是以，上面的例子第二次執行的時候會報錯并啟動失敗，因為第一次執行的時候表已經存在。

https://blog.didispace.com/spring-boot-learning-25-3-13/#%E5%BA%94%E7%94%A8%E5%BB%BA%E8%AE%AE 應用建議

關于這些配置的應用，相信聰明的你一定會把它與資料庫的版本管理聯系起來（因為可以自動的執行腳本）。

那麼依靠這些配置，是否可以勝任業務應用部署時候資料庫初始化的自動化實作呢？

個人認為就上述所介紹的配置，雖然具備了一定的自動執行能力。但由于缺失對目前環境的判斷能力，是以要應對實際的部署場景來說，還是遠遠不夠的。

如果要自動化的管理資料庫表結構、初始化資料的話，我的建議是：

1. 預設提供的這個初始化功能可以且僅用于單元測試，自動建立資料庫結構與初始化資料，使用完畢後銷毀。可以友善的控制每次單元測試的執行環境一緻。
2. 應用在環境部署的時候，還是要使用之前介紹過的Flyway來實作，如何使用可見之前的分享： 使用Flyway來管理資料庫版本 。
3. 聯合Flyway一同使用，通過

   org.springframework.jdbc.datasource.init.DataSourceInitializer

   來定義更複雜的執行邏輯。

本系列教程

《Spring Boot 2.x基礎教程》點選直達！

。學習過程中如遇困難，建議加入

Spring技術交流群

，參與交流與讨論，更好的學習與進步！

https://blog.didispace.com/spring-boot-learning-25-3-13/#%E4%BB%A3%E7%A0%81%E7%A4%BA%E4%BE%8B 代碼示例

本文的相關例子可以檢視下面倉庫中的

chapter3-13

目錄：

• Github： https://github.com/dyc87112/SpringBoot-Learning/
• Gitee： https://gitee.com/didispace/SpringBoot-Learning/

原創不易，如果您覺得本文不錯，歡迎

Star

支援，您的關注是我堅持的動力！