在spring boot项目中，使用h2内存数据库进行开发和测试是常见的实践。它提供了快速的启动速度和便捷的数据库环境。然而，当需要自动执行自定义的sql脚本（例如schema.sql用于创建表结构，data.sql用于填充初始数据）来初始化h2数据库时，开发者可能会遇到“表未找到”或脚本未执行等问题。本文将提供一个详细的教程，指导您如何正确配置spring boot，以实现h2内存数据库的自动模式创建和数据填充。
实现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
关键配置说明：
实体类的定义需要与您的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;
}
}关键点：
将schema.sql和data.sql文件放置在src/main/resources目录下。Spring Boot会自动检测并执行这些文件。
此脚本负责创建数据库表结构。请确保表名和列名与实体定义以及data.sql中的引用一致。
-- src/main/resources/schema.sql
create table items
(
id int not null auto_increment, -- 主键，自增
designation varchar(50) not null,
primary key (id)
);注意事项：
此脚本用于向已创建的表中插入初始数据。
-- src/main/resources/data.sql insert into items(id, designation) values (1, 'EXAMPLE');
注意事项：
标准的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);
}
}通过上述配置，您的Spring Boot应用程序在启动时将能够自动初始化H2内存数据库：
常见问题与排查：
遵循这些指导原则，您将能够有效地在Spring Boot项目中使用H2内存数据库进行自动初始化和数据填充，从而提高开发效率和测试的可靠性。
以上就是Spring Boot中H2内存数据库的自动初始化与脚本填充指南的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
291
收藏
