Spring Boot 3 JPA集成PostGIS：空间查询无结果问题求助

问题背景 #

我们正评估迁移至PostGIS，参考相关文章实现后，通过几何与距离查询数据时无结果（确认数据库存在数据），但全量查询可正常获取所有数据。实现细节如下：

• 实体类使用locationtech的Point定义geom字段
• 仓库层通过原生SQL调用ST_DistanceSphere方法实现近邻查询
• 服务层构建Point参数调用查询
• 已配置相关依赖、Postgres/PostGIS表结构，通过GeoJSON+ogr2ogr命令导入数据

排查与解决步骤 #

1. 修正坐标顺序与SRID一致性 #

PostGIS默认采用WGS84（SRID=4326），且坐标顺序为**(经度, 纬度)**，但LocationTech的Point默认可能是(纬度, 经度)，这是最常见的匹配错误。

• 实体类显式指定SRID：

import org.locationtech.jts.geom.Point;
import org.hibernate.annotations.Type;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;

@Entity
public class Place {
    @Id
    private Long id;
    
    @Column(columnDefinition = "geometry(Point, 4326)")
    @Type(type = "org.hibernate.spatial.GeometryType")
    private Point geom;
    // 其他字段、getter/setter
}

• 服务层构建Point时严格遵循(经度, 纬度)顺序并指定SRID：

import org.locationtech.jts.geom.Coordinate;
import org.locationtech.jts.geom.GeometryFactory;
import org.locationtech.jts.geom.PrecisionModel;

// 固定SRID为4326
GeometryFactory geometryFactory = new GeometryFactory(new PrecisionModel(), 4326);
// 示例：北京坐标（经度116.397，纬度39.908）
Point queryPoint = geometryFactory.createPoint(new Coordinate(116.397, 39.908));

2. 调整原生SQL查询逻辑 #

直接传入LocationTech的Point对象到原生SQL可能出现序列化问题，建议拆分经纬度参数，用PostGIS函数构建查询几何：

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import java.util.List;

public interface PlaceRepository extends JpaRepository<Place, Long> {
    // JPQL方式（推荐，自动处理几何类型转换）
    @Query(value = "SELECT p FROM Place p WHERE ST_DistanceSphere(p.geom, :point) < :distance", nativeQuery = false)
    List<Place> findNearbyPlaces(@Param("point") Point point, @Param("distance") Double distance);
    
    // 原生SQL方式（需手动构建几何对象）
    @Query(value = "SELECT * FROM place WHERE ST_DistanceSphere(geom, ST_SetSRID(ST_MakePoint(:lon, :lat), 4326)) < :distance", nativeQuery = true)
    List<Place> findNearbyPlacesNative(@Param("lon") Double lon, @Param("lat") Double lat, @Param("distance") Double distance);
}

3. 验证导入数据的SRID #

通过ogr2ogr导入GeoJSON时，可能存在SRID不匹配的情况：

• 检查数据库中现有数据的SRID：

SELECT ST_SRID(geom) FROM place LIMIT 1;

• 如果数据SRID不是4326，重新导入时指定坐标系：

ogr2ogr -f "PostgreSQL" PG:"dbname=your_db user=your_user password=your_pwd" input.geojson -t_srs EPSG:4326

4. 确认依赖版本兼容性 #

确保Hibernate Spatial、JTS、PostGIS版本匹配（以Maven为例）：

<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-spatial</artifactId>
    <version>6.4.4.Final</version>
</dependency>
<dependency>
    <groupId>org.locationtech.jts</groupId>
    <artifactId>jts-core</artifactId>
    <version>1.19.0</version>
</dependency>

注：Hibernate 6.x使用org.hibernate.spatial.GeometryType，5.x版本包路径一致但需对应版本适配。

5. 开启SQL日志排查执行语句 #

在application.yml中开启SQL日志，确认实际执行的语句参数是否正确：

spring:
  jpa:
    show-sql: true
    properties:
      hibernate:
        format_sql: true

通过日志检查传入的几何参数格式、ST_DistanceSphere的计算逻辑是否符合预期。

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