如何通过Spring JPA将Postgres VARCHAR[][]映射为String[][]

问题根源 #

你遇到的二进制数据格式错误，是因为Hibernate默认不支持多维数组映射，且原配置中使用的类型转换器未正确适配PostgreSQL的二维varchar[][]类型。以下是两种可行的解决方案：

方案1：使用Hibernate 6原生数组支持（无需第三方库） #

Spring Boot 3.x搭配的Hibernate 6原生支持SQL数组类型映射，无需额外引入依赖：

修改实体类字段注解：

@AllArgsConstructor
@NoArgsConstructor
@Getter
@Entity
@Table(name = "test_table")
public class TestTable {
    @Id
    private String id;

    @JdbcTypeCode(SqlTypes.ARRAY)
    @Column(name = "text_arr", columnDefinition = "varchar[][]", nullable = false)
    private String[][] textArr;
}

• @JdbcTypeCode(SqlTypes.ARRAY) 告诉Hibernate将字段映射为SQL数组类型
• columnDefinition 明确指定PostgreSQL的二维varchar数组类型，确保与数据库表结构匹配

方案2：使用Hibernate Types 60适配多维数组 #

如果需要更复杂的数组处理场景，可引入适配Hibernate 6的第三方类型库：

1. 添加Maven依赖

<dependency>
    <groupId>com.vladmihalcea</groupId>
    <artifactId>hibernate-types-60</artifactId>
    <version>2.21.1</version> <!-- 适配Spring Boot 3.x的最新稳定版 -->
</dependency>

2. 修改实体类注解

@AllArgsConstructor
@NoArgsConstructor
@Getter
@Entity
@Table(name = "test_table")
public class TestTable {
    @Id
    private String id;

    @Type(StringArrayType.class)
    @Column(name = "text_arr", columnDefinition = "varchar[][]", nullable = false)
    private String[][] textArr;
}

• StringArrayType 会自动识别并处理PostgreSQL的多维数组类型，无需额外指定参数

额外检查项 #

• 确保PostgreSQL驱动版本与Spring Boot 3.3.3同步：默认使用的org.postgresql:postgresql 42.7.3版本已适配多维数组
• 验证实体对象的textArr字段：必须是合法的二维字符串数组（如new String[][]{{"a", "b"}, {"c", "d"}}），且不能为null（表字段设置了NOT NULL）

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