使用hibernate-types时遇JdbcSQLSyntaxErrorException：文本数组问题

问题根源在于@DataJpaTest默认使用H2内存数据库，而H2对PostgreSQL风格的text[]数组类型支持不完善，你所用的hibernate-types是针对特定数据库（比如PostgreSQL）实现的类型转换，测试环境的H2无法识别该语法。

以下是几种可行的解决方案：

方案1：让H2启用PostgreSQL兼容模式 #

修改测试环境的数据库配置，让H2模拟PostgreSQL的语法：

• 在src/test/resources/application-test.yml中添加：

spring:
  datasource:
    url: jdbc:h2:mem:testdb;MODE=PostgreSQL;DATABASE_TO_LOWER=TRUE;DB_CLOSE_DELAY=-1
    driver-class-name: org.h2.Driver
  jpa:
    hibernate:
      ddl-auto: create-drop
    properties:
      hibernate:
        dialect: org.hibernate.dialect.PostgreSQLDialect

这样H2会兼容PostgreSQL的数组类型语法，DDL创建表时就能正确识别text[]字段。

方案2：检查实体类注解配置 #

确保实体类中数组字段的注解配置正确，避免因配置缺失导致测试环境识别失败：

import com.vladmihalcea.hibernate.type.array.StringArrayType;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.Id;
import org.hibernate.annotations.Type;

@Entity
public class YourEntity {
    @Id
    @GeneratedValue
    private Long id;

    @Type(type = "com.vladmihalcea.hibernate.type.array.StringArrayType")
    @Column(name = "user_array", columnDefinition = "text[]")
    private String[] userArray;

    // getter、setter
}

方案3：使用Testcontainers运行真实PostgreSQL测试 #

如果需要完全和生产环境一致的测试环境，可以用Testcontainers启动真实的PostgreSQL容器：

1. 引入Testcontainers依赖（以Maven为例）：

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>postgresql</artifactId>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>junit-jupiter</artifactId>
    <scope>test</scope>
</dependency>

2. 在测试类中配置Testcontainers：

import org.junit.jupiter.api.Test;
import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
import org.springframework.test.context.DynamicPropertyRegistry;
import org.springframework.test.context.DynamicPropertySource;
import org.testcontainers.containers.PostgreSQLContainer;
import org.testcontainers.junit.jupiter.Container;
import org.testcontainers.junit.jupiter.Testcontainers;

@DataJpaTest
@Testcontainers
public class YourEntityRepositoryTest {

    @Container
    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:15");

    @DynamicPropertySource
    static void configureProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", postgres::getJdbcUrl);
        registry.add("spring.datasource.username", postgres::getUsername);
        registry.add("spring.datasource.password", postgres::getPassword);
    }

    // 测试方法
    @Test
    void testSaveEntity() {
        // 测试逻辑
    }
}

这种方式完全模拟生产环境的数据库，不会出现类型兼容问题，但测试启动速度会稍慢。

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