Spring项目Dev Profile下H2持久化数据库无法正常连接求助

问题现象 #

执行mvn spring-boot:run -Pdev启动服务后出现以下问题：

• 实体类（如Author、Book）对应的数据库表未自动创建
• 需手动创建dev.mv.db文件才能尝试连接数据库
• 日志显示Spring仍使用带随机ID的内存H2数据库（如jdbc:h2:mem:42222461-e6cf-4a77-9ca5-c321a81eb65a），application-dev.yml中的持久化配置未生效

排查步骤与解决方案 #

1. 绑定Maven Profile与Spring Profile #

Spring不会自动识别Maven Profile，需在pom.xml中明确映射，确保Spring加载对应环境配置：

<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <spring.profiles.active>dev</spring.profiles.active>
        </properties>
        <activation>
            <activeByDefault>false</activeByDefault>
        </activation>
    </profile>
</profiles>

也可直接在启动命令中强制指定Spring Profile：

mvn spring-boot:run -Pdev -Dspring.profiles.active=dev

2. 修正application-dev.yml的H2配置 #

检查配置语法与关键参数，确保持久化路径和表生成规则正确：

spring:
  datasource:
    url: jdbc:h2:file:./dev # 持久化到项目根目录的dev.mv.db文件
    driver-class-name: org.h2.Driver
    username: sa
    password:
  jpa:
    hibernate:
      ddl-auto: update # 自动创建/更新表结构，设为none则不生成表
    show-sql: true
  h2:
    console:
      enabled: true # 可选，开启控制台便于调试

3. 确认实体类扫描范围 #

确保主启动类能扫描到实体类所在包，若实体类不在启动类同级或子包下，需手动添加@EntityScan：

@SpringBootApplication
@EntityScan(basePackages = "com.yourproject.entity") // 替换为你的实体类包路径
public class BookApplication {
    public static void main(String[] args) {
        SpringApplication.run(BookApplication.class, args);
    }
}

4. 检查Maven资源过滤配置 #

确保application-dev.yml被正确打包到classpath，pom.xml需添加资源过滤配置：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

5. 验证Profile是否生效 #

启动时添加日志参数，查看Spring激活的Profile：

mvn spring-boot:run -Pdev -Dlogging.level.org.springframework.core.env=DEBUG

日志中若出现ActiveProfiles [dev]则说明Profile生效；若未出现，检查Maven Profile的激活逻辑是否正确。

6. 确认H2依赖配置 #

确保pom.xml中正确引入H2依赖，scope设为runtime即可：

<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>

验证方法 #

修改配置后重启服务，查看日志中的数据库URL是否为jdbc:h2:file:./dev，同时检查项目根目录是否自动生成dev.mv.db文件。访问http://localhost:8080/h2-console，输入配置的URL和账号密码，即可看到自动生成的实体表。

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