如何在Hibernate 6.5中使用JPA映射二维（多维）数组？

Hibernate 6.5目前没有官方原生支持直接映射float[][]这类多维数组的能力，除了你提到的JSONB映射方案，还有两种实用的替代思路：

1. 自定义类型映射（适配数据库原生多维数组） #

如果你的数据库（比如PostgreSQL）本身支持原生多维数组类型，可以自行实现Hibernate的类型处理器来适配：

public class Float2DArrayType implements BasicType<float[][]>, DynamicParameterizedType {
    @Override
    public String getName() {
        return "float2d-array";
    }

    @Override
    public Class<float[][]> getJavaType() {
        return float[][].class;
    }

    @Override
    public SqlTypeDescriptor getSqlTypeDescriptor() {
        return ArraySqlTypeDescriptor.INSTANCE;
    }

    @Override
    public JavaTypeDescriptor<float[][]> getJavaTypeDescriptor() {
        return new JavaTypeDescriptor<>() {
            @Override
            public Class<float[][]> getJavaType() {
                return float[][].class;
            }

            @Override
            public float[][] fromString(String string) {
                // 根据实际需求实现字符串转二维float数组逻辑
                return null;
            }

            @Override
            public String toString(float[][] value) {
                // 根据实际需求实现二维float数组转字符串逻辑
                return null;
            }

            @Override
            public <X> X unwrap(float[][] value, Class<X> type, WrapperOptions options) {
                if (value == null) {
                    return null;
                }
                if (Array.class.isAssignableFrom(type)) {
                    try {
                        return (X) options.getSession().getJdbcConnectionAccess().obtainConnection()
                                .createArrayOf("float8", Arrays.stream(value)
                                        .map(row -> Arrays.stream(row).boxed().toArray())
                                        .toArray());
                    } catch (SQLException e) {
                        throw new RuntimeException(e);
                    }
                }
                throw new IllegalArgumentException("Cannot unwrap float[][] to " + type);
            }

            @Override
            public <X> float[][] wrap(X value, WrapperOptions options) {
                if (value == null) {
                    return null;
                }
                if (value instanceof Array) {
                    try {
                        Object[] rows = (Object[]) ((Array) value).getArray();
                        return Arrays.stream(rows)
                                .map(row -> (float[]) row)
                                .toArray(float[][]::new);
                    } catch (SQLException e) {
                        throw new RuntimeException(e);
                    }
                }
                throw new IllegalArgumentException("Cannot wrap " + value.getClass() + " to float[][]");
            }
        };
    }

    @Override
    public void setParameterValues(Properties parameters) {
        // 按需处理参数配置
    }
}

之后在实体类中指定自定义类型：

@Entity
public class MyEntity {
    @Type(Float2DArrayType.class)
    @Column(columnDefinition = "float8[][]")
    private float[][] myArray;
}

2. 用嵌入类封装一维数组，通过集合映射 #

把二维数组拆分为包含一维数组的嵌入类，再用@ElementCollection映射：

@Embeddable
public class FloatRow {
    private float[] values;

    // 构造器、Getter、Setter省略
}

@Entity
public class MyEntity {
    @ElementCollection
    @CollectionTable(name = "my_entity_float_rows", joinColumns = @JoinColumn(name = "my_entity_id"))
    private List<FloatRow> my2DArray;
}

这种方式会生成关联表存储二维数组的每一行，适合需要单独操作数组行的场景。

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