使用@AutoConfigureTestDatabase测试时出现CommandAcceptanceException问题

问题背景 #

在Spring Boot项目中编写URLRepositoryTest测试类，使用@DataJpaTest和@AutoConfigureTestDatabase(connection = EmbeddedDatabaseConnection.H2)指定H2嵌入式数据库。启动测试时控制台抛出CommandAcceptanceException，原因是Hibernate尝试执行drop table urls cascade语句，但目标表不存在。测试未失败但单测试耗时约1秒，怀疑耗时异常与该异常有关。

测试类代码 #

@DataJpaTest
@AutoConfigureTestDatabase(connection = EmbeddedDatabaseConnection.H2)
public class URLRepositoryTest {

    @Autowired
    private URLRepository urlRepository;

    @Test
    public void getURLById() {
        // Arrange
        String urlToCheck = "https://github.com/";
        URL url = URL.builder()
                .url(urlToCheck).build();

        urlRepository.save(url);

        // Act
        URL saved = urlRepository.findById(url.getId()).get();

        // Assert
        Assertions.assertThat(saved).isNotNull();
        Assertions.assertThat(saved.getId()).isEqualTo(url.getId());
        Assertions.assertThat(saved.getUrl()).isEqualTo(urlToCheck);
    }
}

实体类代码 #

@Entity
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "urls")
public class URL {

    public URL(String url) {
        this.url = url;
    }

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(name = "url")
    private String url;
}

异常日志关键信息 #

org.hibernate.tool.schema.spi.CommandAcceptanceException: Error executing DDL "drop table urls cascade" via JDBC Statement
Caused by: org.h2.jdbc.JdbcSQLSyntaxErrorException: 表 "URLS" 未找到
Table "URLS" not found; SQL statement:
drop table urls cascade [42102-224]

解决方法 #

方法1：让DROP语句仅在表存在时执行 #

在测试环境配置文件（如application-test.properties）中添加以下配置，让Hibernate生成的DROP TABLE语句自动带上IF EXISTS关键字，避免表不存在时抛出异常：

spring.jpa.properties.hibernate.schema_drop_sql_extra_jdbc_parameters=IF EXISTS

方法2：调整DDL自动生成策略 #

修改spring.jpa.hibernate.ddl-auto配置，根据需求选择合适的策略：

• 设置为create：每次启动测试时创建新表，不会执行DROP语句（除非之前存在表）
• 设置为update：仅在实体类结构变化时更新表结构，无需每次删除重建

spring.jpa.hibernate.ddl-auto=create

方法3：统一表名大小写匹配 #

H2数据库默认将未加引号的表名转为大写，而Hibernate默认用小写生成DDL语句，导致表名匹配失败。可以通过以下两种方式解决：

1. 修改实体类的@Table注解为大写表名：

   @Table(name = "URLS")
   

2. 开启Hibernate全局引号标识符，强制保持表名和列名的大小写一致：

   spring.jpa.properties.hibernate.globally_quoted_identifiers=true
   

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