Spring Boot中如何通过静态SQL文件加载H2数据库？路径问题求助

核心问题分析 #

你混淆了H2数据库文件的存储路径和SQL初始化脚本的作用：

• data.sql是Spring Boot用来初始化数据库数据的脚本，不是H2数据库的物理文件（H2数据库文件通常以.db为后缀）。
• 你的spring.datasource.url配置指向了脚本文件，这会导致H2尝试把data.sql当作数据库文件打开，自然无法识别有效数据库。

正确配置方案 #

1. 配置H2数据库存储路径（兼容Docker） #

使用相对路径或Spring Boot内置变量，确保本地和Docker容器中都能正常工作：

# 数据库文件存储在项目根目录下的h2文件夹，重启后数据不会丢失
spring.datasource.url=jdbc:h2:file:./h2/db;DB_CLOSE_ON_EXIT=FALSE
# 若无需持久化数据，可使用内存模式（重启后数据清空）
# spring.datasource.url=jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1

2. 自动执行data.sql初始化脚本 #

Spring Boot默认会自动加载src/main/resources下的data.sql，只需确保：

• data.sql放在src/main/resources目录下
• 显式开启SQL初始化（默认已开启，可配置增强可靠性）：

spring.sql.init.mode=always

3. 完整配置示例 #

# H2基础配置
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.url=jdbc:h2:file:./h2/db;DB_CLOSE_ON_EXIT=FALSE
spring.datasource.username=sa
spring.datasource.password=

# H2控制台（可选，用于调试）
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console

# SQL初始化配置
spring.sql.init.mode=always

验证与Docker适配 #

1. 启动应用后，H2会自动创建./h2/db.mv.db数据库文件，data.sql中的SQL会自动执行初始化数据
2. 访问http://localhost:8080/h2-console，使用配置的url连接数据库，可查看初始化结果
3. Docker部署时，若需持久化数据库文件，运行容器时挂载本地目录：

docker run -v ./h2:/app/h2 -p 8080:8080 your-spring-boot-image

内容的提问来源于stack exchange，提问作者user352290