引言
在spring boot项目中，使用h2内存数据库进行开发和测试是常见的实践。它提供了快速的启动速度和便捷的数据库环境。然而，当需要自动执行自定义的sql脚本（例如schema.sql用于创建表结构，data.sql用于填充初始数据）来初始化h2数据库时，开发者可能会遇到“表未找到”或脚本未执行等问题。本文将提供一个详细的教程，指导您如何正确配置spring boot，以实现h2内存数据库的自动模式创建和数据填充。
1. 核心配置：application.properties
实现H2内存数据库自动初始化，关键在于application.properties中的一系列配置。这些配置协同工作，确保Spring Boot能够识别并执行您的SQL脚本。
# 启用H2控制台，方便查看数据库状态 spring.h2.console.enabled=true # H2数据库连接URL，使用内存模式，DB_CLOSE_DELAY=-1表示JVM不关闭数据库不关闭 spring.datasource.url=jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1 # 数据库用户名和密码 spring.datasource.username=root spring.datasource.password=root # H2数据库驱动 spring.datasource.driverClassName=org.h2.Driver # JPA/Hibernate相关配置 # 指定H2方言 spring.jpa.database-platform=org.hibernate.dialect.H2Dialect spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.H2Dialect # 启用DDL生成，Hibernate将根据实体自动创建/更新表结构 spring.jpa.generate-ddl=true # Hibernate的DDL自动模式，'update'会在启动时更新数据库模式 spring.jpa.hibernate.ddl-auto=update # 格式化SQL输出，便于调试 spring.jpa.properties.hibernate.format_sql=true # 在SQL日志中显示SQL注释 spring.jpa.properties.hibernate.use_sql_comments=true # 数据库初始化关键配置 # 延迟数据源初始化，确保在执行SQL脚本前数据源已完全准备好 spring.jpa.defer-datasource-initialization=true # 数据库初始化模式：'always'表示每次启动都执行schema.sql和data.sql spring.sql.init.mode=always # 脚本执行出错时是否继续，生产环境需谨慎 spring.sql.init.continue-on-error=true # 以下是Spring Session的配置，与核心问题无关，但如果项目中使用了可保留 # spring.session.jdbc.initialize-schema=always
关键配置说明：
- spring.jpa.defer-datasource-initialization=true: 至关重要。它确保Spring Boot在数据源完全初始化并可用之后，才尝试执行任何自定义的SQL脚本。这避免了在数据源尚未完全准备好时，脚本执行失败的问题。
- spring.sql.init.mode=always: 核心配置。此属性指示Spring Boot在每次应用程序启动时，都查找并执行类路径下的schema.sql和data.sql文件。其他可选值包括embedded（仅适用于嵌入式数据库）和never。
- spring.jpa.hibernate.ddl-auto=update: Hibernate会根据您的实体类来管理数据库模式。在有自定义schema.sql的情况下，需要注意其与ddl-auto的交互。通常，如果schema.sql负责完整的表创建，ddl-auto可以设置为none或validate。但在此场景下，update可以与脚本配合使用，由Hibernate处理实体与数据库的同步。
- spring.sql.init.continue-on-error=true: 当SQL脚本中存在错误时，此属性允许初始化过程继续进行，而不是立即失败。在开发阶段可能有用，但在生产环境中应谨慎使用或设置为false以确保数据一致性。
2. 实体定义：Item.java
实体类的定义需要与您的SQL脚本保持一致，尤其是在表名和列名方面。H2数据库默认对标识符（表名、列名）不区分大小写，但Hibernate在生成SQL时可能会遵循Java命名约定。为避免潜在问题，建议在实体和SQL脚本中统一使用小写命名。
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;
@Entity(name = "ITEM_ENTITY") // 可选：指定Hibernate实体名
@Table(name = "items") // 明确指定数据库表名为小写"items"
public class Item {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY) // 使用IDENTITY策略，H2支持自增
private Long id;
private String designation; // 列名保持小写
// 构造函数、Getter和Setter（省略）
public Item() {}
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getDesignation() {
return designation;
}
public void setDesignation(String designation) {
this.designation = designation;
}
}关键点：
- @Table(name = "items"): 明确指定数据库中的表名为小写items。这与schema.sql中的表名保持一致。
- @GeneratedValue(strategy = GenerationType.IDENTITY): 对于H2数据库，IDENTITY是推荐的自增主键生成策略，它与AUTO_INCREMENT（或H2中的GENERATED ALWAYS AS IDENTITY）兼容。
3. SQL初始化脚本
将schema.sql和data.sql文件放置在src/main/resources目录下。Spring Boot会自动检测并执行这些文件。
3.1 模式定义：schema.sql
此脚本负责创建数据库表结构。请确保表名和列名与实体定义以及data.sql中的引用一致。
-- src/main/resources/schema.sql
create table items
(
id int not null auto_increment, -- 主键，自增
designation varchar(50) not null,
primary key (id)
);注意事项：
- 表名和列名均使用小写，以避免跨数据库或配置不当导致的大小写敏感问题。
- id int not null auto_increment：定义了一个自增主键。
3.2 数据填充：data.sql
此脚本用于向已创建的表中插入初始数据。
-- src/main/resources/data.sql insert into items(id, designation) values (1, 'EXAMPLE');
注意事项：
- insert into items(...)：表名与schema.sql和实体中的定义保持一致。
- 列名也应与表定义一致。
4. 主应用程序类：MainApplication.java
标准的Spring Boot启动类，无需特殊修改。
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class MainApplication {
public static void main(String[] args) {
SpringApplication.run(MainApplication.class, args);
}
}5. 总结与注意事项
通过上述配置，您的Spring Boot应用程序在启动时将能够自动初始化H2内存数据库：
- Spring Boot会首先根据spring.sql.init.mode=always找到并执行schema.sql，创建items表。
- 接着，根据data.sql插入初始数据。
- 同时，由于spring.jpa.hibernate.ddl-auto=update，Hibernate也会根据Item实体来检查和更新数据库模式（在此场景下，由于脚本已经创建，Hibernate会发现表已存在并保持一致）。
- spring.jpa.defer-datasource-initialization=true确保了脚本执行时数据源已完全可用，避免了时序问题。
常见问题与排查：
-
“Table "ITEMS" not found”错误：
- 大小写不一致： H2默认不区分大小写，但Hibernate或某些配置可能导致问题。确保实体中的@Table(name = "items")、schema.sql和data.sql中的表名都是小写且一致。
- 脚本未执行： 检查spring.sql.init.mode是否设置为always，以及spring.jpa.defer-datasource-initialization是否为true。
- ddl-auto冲突： 如果ddl-auto设置为create或create-drop，Hibernate可能会在脚本执行之前尝试创建表，导致冲突。update模式通常能更好地与自定义脚本配合。
- 数据未插入： 确认data.sql的路径正确，且spring.sql.init.mode=always已设置。检查SQL语句本身是否有语法错误。
- H2控制台无法访问： 确保spring.h2.console.enabled=true且访问路径正确（通常是http://localhost:8080/h2-console）。
遵循这些指导原则，您将能够有效地在Spring Boot项目中使用H2内存数据库进行自动初始化和数据填充，从而提高开发效率和测试的可靠性。
