Spring Boot 3.1.1应用启动失败：JdbcSqlSyntaxErrorException求助

环境信息 #

• Spring Boot版本：3.1.1
• 整合组件：JPA、Hibernate、H2内存数据库
• 核心问题：应用启动时抛出JdbcSqlSyntaxErrorException，进程直接终止

核心排查方向 #

1. 实体类与数据库表映射冲突 #

• 检查实体类@Table注解：若表名为H2关键字（如user），需用反引号包裹表名，示例：

  @Entity
  @Table(name = "`user`")
  public class User {
      // 类内容
  }
  

• 确认spring.jpa.hibernate.ddl-auto配置：若设为none，Hibernate不会自动生成表，需手动创建；建议设置为create/update/create-drop触发自动建表逻辑。

2. H2方言配置错误 #

确保application.properties/application.yml中方言配置正确，Spring Boot 3.x对应Hibernate 6.x，方言类路径不可写错：

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

3. H2数据库连接URL问题 #

检查数据源URL格式是否正确，内存库标准格式为：

spring.datasource.url=jdbc:h2:mem:testdb

注意库名拼写一致，避免因URL错误导致无法连接目标库。

4. 依赖版本兼容性 #

Spring Boot 3.1.1默认管理的H2版本为2.2.224，若手动指定其他版本，可能存在兼容性冲突，建议直接使用Spring Boot父依赖管理的版本，无需手动指定H2版本。

5. 开启SQL日志验证DDL语句 #

添加以下配置开启Hibernate SQL日志，查看自动生成的建表语句是否正确：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

通过日志可确认表是否被正确创建，以及查询语句是否存在语法错误。

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