Spring Boot+Hibernate打包后SQL方言自动切换为H2问题求助

可能原因及对应解决方案 #

1. H2依赖未限制为测试范围 #

如果项目中引入了H2数据库依赖，且其scope未设置为test，打包后H2会被包含在Jar中，Spring Boot自动配置会优先检测到H2并切换方言。

修改pom.xml中的H2依赖：

<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>test</scope> <!-- 仅在测试环境生效 -->
</dependency>

2. 配置文件未正确打包或激活错误Profile #

• 解压生成的Jar包，检查BOOT-INF/classes/application.properties是否包含完整的MySQL配置：

  spring.datasource.url=jdbc:mysql://localhost:3306/your_db?useSSL=false&serverTimezone=UTC
  spring.datasource.username=your_user
  spring.datasource.password=your_pass
  spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
  spring.jpa.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
  spring.jpa.database-platform=org.hibernate.dialect.MySQL8Dialect
  

• 确认运行Jar时激活了正确的配置Profile，比如IDE使用dev但Jar运行未指定：

  java -jar your-app.jar --spring.profiles.active=dev
  

3. 使用了过时的方言配置 #

Spring Boot 3.x搭配MySQL 8.0需适配新版方言，替换旧配置：

spring.jpa.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
spring.jpa.database-platform=org.hibernate.dialect.MySQL8Dialect

4. 代码中存在硬编码的方言设置 #

检查项目中的@Configuration类，是否存在硬编码覆盖配置文件的情况：

@Bean
public LocalContainerEntityManagerFactoryBean entityManagerFactory() {
    LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
    // 若此处硬编码设置H2方言，会覆盖配置文件内容
    em.setJpaProperty("hibernate.dialect", "org.hibernate.dialect.H2Dialect");
    return em;
}

如有此类代码，改为读取配置文件或直接移除硬编码。

5. 确认MySQL驱动依赖正确 #

确保MySQL驱动依赖适配Spring Boot 3.0.5：

<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope>
</dependency>

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