Spring Boot数据库初始化机制概述
spring boot提供了一种便捷的机制来自动初始化数据库模式和数据。默认情况下，如果项目中存在src/main/resources/schema.sql和src/main/resources/data.sql文件，spring boot会在应用程序启动时自动执行它们，分别用于创建数据库表结构和填充初始数据。
为了支持不同数据库类型（如MySQL、PostgreSQL、H2等），Spring Boot还允许使用平台特定的脚本文件。例如，对于MySQL数据库，您可以将模式定义放在schema-mysql.sql中，将数据填充放在data-mysql.sql中。在Spring Boot 2.5版本之前，要激活这些平台特定的脚本，需要在application.properties中设置spring.datasource.platform属性。
配置属性的演变：spring.datasource.platform 到 spring.sql.init.platform
在Spring Boot 2.5.0版本发布后，为了更好地分离数据源配置和SQL初始化配置的职责，spring.datasource.platform属性被废弃并替换为spring.sql.init.platform。这意味着，如果您正在使用Spring Boot 2.5或更高版本（例如2.7.5），并尝试使用旧的spring.datasource.platform属性来指定平台，那么您的平台特定SQL脚本将不会被执行，且通常不会抛出任何错误，导致数据库初始化静默失败。
这一变更旨在使配置更加清晰和模块化。spring.datasource.*系列属性现在主要关注数据源连接本身，而spring.sql.init.*系列属性则专门管理SQL脚本的初始化行为。
如何在现代Spring Boot应用中配置平台特定SQL脚本
要在Spring Boot 2.5及更高版本中正确地使用平台特定的SQL初始化脚本，您需要修改application.properties文件，将旧的属性替换为新的属性。
1. SQL脚本文件命名
保持平台特定脚本的命名约定不变。例如，对于MySQL：
- 模式定义：src/main/resources/schema-mysql.sql
- 数据填充：src/main/resources/data-mysql.sql
2. application.properties配置
在application.properties文件中，使用spring.sql.init.platform属性来指定目标数据库平台。
# 数据库连接配置 (示例) spring.datasource.url=jdbc:mysql://localhost:3306/your_database?useSSL=false&serverTimezone=UTC spring.datasource.username=your_user spring.datasource.password=your_password spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver # 激活数据库初始化 (如果需要，默认为true) spring.sql.init.mode=always # 指定数据库平台，以执行平台特定SQL脚本 # 在Spring Boot 2.5+ 版本中使用 spring.sql.init.platform=mysql # 注意：以下属性在Spring Boot 2.5+ 版本中已无效，不应使用 # spring.datasource.platform=mysql
示例：schema-mysql.sql
CREATE TABLE IF NOT EXISTS users (
id INT AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(255) NOT NULL,
email VARCHAR(255) UNIQUE NOT NULL
);示例：data-mysql.sql
INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com');
INSERT INTO users (name, email) VALUES ('Bob', 'bob@example.com');当您使用上述配置启动Spring Boot应用程序时，如果spring.sql.init.platform被设置为mysql，Spring Boot将查找并执行schema-mysql.sql和data-mysql.sql文件。
注意事项与故障排除
- Spring Boot版本检查： 在遇到类似问题时，首先检查您的Spring Boot版本。这是确定应使用哪个属性的关键。
- 脚本文件位置： 确保SQL脚本文件位于src/main/resources目录下，或者通过spring.sql.init.schema-locations和spring.sql.init.data-locations明确指定了其路径。
- spring.sql.init.mode： 默认情况下，数据库初始化是开启的。如果您的脚本没有执行，请检查spring.sql.init.mode是否被设置为always或embedded（对于嵌入式数据库）。如果设置为never，则初始化将被禁用。
- 日志输出： 仔细检查应用程序启动日志。Spring Boot通常会输出有关SQL脚本执行的信息，这有助于诊断问题。
- 数据库连接： 确保application.properties中的数据库连接信息（URL、用户名、密码）正确无误，并且应用程序能够成功连接到目标数据库。
- 文件编码： 确保SQL脚本文件的编码与数据库期望的编码一致，通常是UTF-8。
总结
Spring Boot在不断演进，配置属性也可能随之调整。对于数据库初始化，从Spring Boot 2.5版本开始，用于指定平台特定SQL脚本的属性已从spring.datasource.platform迁移至spring.sql.init.platform。理解并应用这一变更对于确保您的Spring Boot应用程序能够正确、高效地初始化数据库至关重要。在开发和维护Spring Boot项目时，查阅官方文档或发行说明是及时了解这些变更的最佳实践。
