Spring Boot配置MariaDB时Hibernate方言无法解析如何解决

问题根因 #

你遇到的Unable to resolve name [org.hibernate.dialect.MariaDB103Dialect] as strategy [org.hibernate.dialect.Dialect]错误，核心原因是当前项目依赖的Hibernate版本过低：MariaDB103Dialect是Hibernate 5.4版本才正式纳入官方内置方言库的类，低于5.4的Hibernate版本无法找到这个类。

解决方案（二选一即可） #

方案1：升级Hibernate版本到5.4及以上 #

• 如果你用的是Spring Boot项目，直接将Spring Boot版本升级到2.2.x及以上即可，该版本起默认内置的Hibernate版本为5.4+，无需单独调整Hibernate依赖。
• 若不想升级Spring Boot版本，可单独在依赖管理中指定hibernate-core的版本为5.4或更高版本即可。

方案2：替换为兼容低版本Hibernate的方言 #

如果暂时无法升级依赖，可以将database-platform的取值替换为老版本Hibernate支持的MariaDB方言，10.3.31版本的MariaDB可以完美兼容以下两种方言：

spring:
  jpa:
    properties:
      hibernate:
        show_sql: true
        format_sql: true
    # 可选1：适配MariaDB 10.x全系列的方言
    database-platform: org.hibernate.dialect.MariaDB10Dialect
    # 可选2：通用MariaDB方言，兼容性更强
    # database-platform: org.hibernate.dialect.MariaDBDialect

额外注意事项 #

注意yml配置的缩进层级不要出错，database-platform要和properties平级，放在spring.jpa下；也可以直接把方言配置到spring.jpa.properties.hibernate.dialect下，两种配置效果完全一致，不要同时配置避免冲突。

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