SpringBoot项目无法从H2内存库切换到MySQL持久化数据库求助

以下是几个常见的问题点及对应解决办法：

1. 依赖配置问题 #

• 检查项目构建文件（pom.xml或build.gradle），确认H2数据库的依赖已移除，比如Maven中删除这段：

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

• 确保MySQL驱动依赖已正确引入，Maven示例：

  <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <scope>runtime</scope>
  </dependency>
  

  Gradle示例：

  runtimeOnly 'mysql:mysql-connector-java:8.0.33'
  

2. 配置文件被覆盖或未生效 #

• 检查是否存在优先级更高的配置：比如启动时指定了环境（如spring.profiles.active=dev），要确认对应环境的配置文件（application-dev.properties）里是MySQL的配置；系统环境变量、JVM参数或命令行参数也会覆盖application.properties的内容，可通过启动日志的Property Sources段查看加载的配置来源。
• 确认application.properties中的MySQL配置无误，示例配置：

  spring.datasource.url=jdbc:mysql://localhost:3306/你的数据库名?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
  spring.datasource.username=你的数据库账号
  spring.datasource.password=你的数据库密码
  spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
  spring.h2.console.enabled=false
  

3. 硬编码的H2数据源配置 #

• 检查项目中是否有自定义的DataSource配置类，或者启动类上的注解硬指定了H2相关配置。如果存在手动创建H2数据源的@Bean方法，需要修改为MySQL配置，或者直接删除该自定义配置类，让SpringBoot自动适配MySQL数据源。

4. IDE缓存或构建残留 #

• 清理IDE缓存（比如IntelliJ IDEA的File -> Invalidate Caches...），然后重新构建项目。
• 执行mvn clean install（Maven）或gradle clean build（Gradle），确保编译后的包中使用的是最新的配置文件，避免旧的H2配置被打包进去。

5. 自动配置优先级冲突 #

• 如果项目中同时存在H2和MySQL依赖，SpringBoot自动配置可能优先选择H2。可以在启动类上排除H2相关自动配置类，强制使用MySQL：

  @SpringBootApplication(exclude = {H2ConsoleAutoConfiguration.class})
  

  若仍不生效，可尝试排除DataSourceAutoConfiguration，之后确保MySQL配置正确，让SpringBoot重新自动配置数据源。

内容的提问来源于stack exchange，提问作者Miguel Angel Guaita