升级Spring Boot2.7测试失败 报CommandAcceptanceException DDL错误

Spring Boot 2.7版本默认将内嵌H2数据库的依赖版本从1.4.x系列升级到2.x系列，H2 2.x版本扩充了SQL保留关键字列表，USER被纳入保留关键字范畴，不允许直接作为无转义的标识符（表名、列名）使用。
从提供的报错日志可以看到，语法错误标记位置正好在user表名处（create table [*]user），就是因为H2解析DDL时将user识别为关键字而非自定义表名，直接抛出语法错误，导致建表失败，后续依赖该表的测试自然全部运行失败。

• 确认依赖版本：执行依赖查看命令确认运行时H2版本，Maven环境执行mvn dependency:tree | grep h2，Gradle环境执行./gradlew dependencies | grep h2，确认H2版本为2.x以上，匹配版本升级带来的行为变更前提。
• 定位错误位置：查看报错栈中Caused by部分的错误信息，错误码为42001-212，语法错误指针直接指向user表名位置，排除字段约束、SQL写法错误等其他问题。
• 匹配保留字规则：对照H2 2.x的保留关键字列表，确认USER属于必须转义才能作为标识符使用的关键字，锁定冲突原因。

按优先级从高到低可选以下方案：

• 方案1（最推荐，无跨环境兼容问题）：在JPA实体类中对表名做显式转义，JPA会自动适配不同数据库的标识符转义规则，不管测试用H2还是生产环境用其他数据库都不会出现关键字冲突问题。
  在User实体类的@Table注解中，用反引号包裹表名即可：

  // 如果是Spring Boot 2.7默认的jakarta包路径用这个导入，还在使用javax的换成javax.persistence.Table即可
  import jakarta.persistence.Entity;
  import jakarta.persistence.Table;
  
  @Entity
  @Table(name = "`user`")
  public class User {
      // 实体属性、方法省略
  }
  

  配置后Hibernate自动生成的建表语句会给表名加上对应数据库的转义符，H2下会生成带双引号的合法表名，不会触发关键字冲突。
• 方案2（适合测试场景，无需修改业务代码）：在测试环境的数据源配置中，通过JDBC参数指定H2不将USER识别为关键字，直接在连接串末尾添加NON_KEYWORDS参数即可：

  # application-test.properties 配置
  spring.datasource.url=jdbc:h2:mem:testdb;NON_KEYWORDS=USER
  

  如果还有其他用到的保留字冲突，用逗号分隔追加在参数后即可，例如NON_KEYWORDS=USER,VALUE,ORDER。
• 方案3（临时方案，不推荐长期使用）：显式指定H2版本为1.4.200（Spring Boot 2.6默认绑定的版本），回退到旧版本行为规避关键字问题。Maven环境在pom.xml中添加如下依赖配置即可：

  <dependency>
      <groupId>com.h2database</groupId>
      <artifactId>h2</artifactId>
      <version>1.4.200</version>
      <scope>test</scope>
  </dependency>
  

  注意Spring Boot 3.x及以上版本最低支持H2 2.x，该方案无法用于后续版本升级，仅适合临时快速验证场景。

修改完成后重新运行集成测试，查看启动日志中没有之前的CommandAcceptanceExceptionDDL执行报错，User表创建成功，相关数据库操作正常执行即代表修复完成。

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