Spring Boot 3+Hibernate 6.2.2中Specification查询几何数据报错

问题场景 #

我正在开发一款存储Geometry数据的Spring Boot应用，采用Spring Data的Specification进行查询，环境为Spring Boot 3和Hibernate 6.2.2。运行代码时出现以下错误：

Passed invariantType for function return cannot be null

相关代码：

Expression<Geometry> geography = cb.function("geography", Geometry.class, root.get("point"));
Expression<Point> point = cb.function("point", Point.class, cb.literal(longitude),
cb.literal(latitude));
Expression<Point> comparisonPoint = cb.function("ST_SetSRID", Point.class, point,
cb.literal(4326));
Expression<Boolean> expression = cb.function(SpatialFunction.dwithin.toString(), boolean.class,
geography, comparisonPoint, cb.literal(radius));

return cb.equal(expression, true);

问题原因 #

1. Hibernate 6.x对cb.function()的返回类型处理更严格，直接使用boolean.class这种基本类型会导致类型校验失败，触发invariantType为空的错误。
2. 调用dwithin函数时，参数类型不匹配：geography是地理类型，而comparisonPoint是几何类型（Point），两者无法直接进行空间计算。
3. 冗余的cb.equal(expression, true)写法，没必要将布尔表达式再包装一层相等判断。

修复代码 #

// 将数据库中的Point字段转换为Geography类型
Expression<Geometry> geography = cb.function("geography", Geometry.class, root.get("point"));

// 创建Point并设置SRID，再转换为同类型的Geography
Expression<Point> point = cb.function("point", Point.class, cb.literal(longitude), cb.literal(latitude));
Expression<Point> sridPoint = cb.function("ST_SetSRID", Point.class, point, cb.literal(4326));
Expression<Geometry> comparisonGeography = cb.function("geography", Geometry.class, sridPoint);

// 调用dwithin函数，使用包装类Boolean.class作为返回类型
Expression<Boolean> expression = cb.function(
    SpatialFunction.dwithin.toString(), 
    Boolean.class, 
    geography, 
    comparisonGeography, 
    cb.literal(radius)
);

// 直接返回布尔表达式即可
return expression;

额外注意事项 #

• Hibernate 6对空间函数的参数类型校验比旧版本严格，必须保证所有参与计算的空间类型一致。
• 若使用PostGIS，dwithin针对Geography类型的参数，距离单位是米；针对Geometry类型则是空间参考系的单位（通常为度），需根据业务需求选择。

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