如何在MySQL与JPA中使用NEAR？遇Unsupported keyword NEAR错误

我明白你遇到的困扰了——Spring Data JPA的自动查询生成器没办法直接支持MySQL的NEAR地理查询，因为JPQL本身没有这个空间查询语法，而MySQL的地理查询需要用它专属的空间函数（比如ST_DWithin、ST_Distance_Sphere）来实现。下面是一步步的解决方案：

问题根源 #

Spring Data JPA的findByXxxNear方法默认是为支持JPQL地理扩展的数据库设计的（比如PostgreSQL + PostGIS），但MySQL并没有被Spring Data JPA的默认查询生成器纳入支持范围，所以才会抛出Unsupported keyword NEAR的错误。

解决方案步骤 #

1. 添加Hibernate Spatial依赖（关键） #

MySQL的地理空间类型需要Hibernate的空间扩展来完成实体映射和查询支持，先在你的pom.xml中添加这个依赖：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-spatial</artifactId>
    <version>5.2.17.Final</version> <!-- 版本和Spring Boot 2.0.x系列匹配，无需额外调整 -->
</dependency>

2. 修正实体类的地理字段映射 #

把原来的GeoJsonPoint替换为Hibernate Spatial支持的Point类型，确保字段正确映射到MySQL的POINT类型：

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;
import org.hibernate.annotations.Type;
import com.vividsolutions.jts.geom.Point;

@Entity
public class GeoTest {
    @Id
    private String id;
    
    // 明确映射到MySQL的POINT空间类型
    @Column(columnDefinition = "POINT")
    @Type(type = "org.hibernate.spatial.GeometryType")
    private Point location;

    // Getters and Setters
}

3. 改用原生SQL实现"Near"查询 #

既然自动生成查询行不通，我们用@Query注解写原生MySQL查询来实现附近地点的查询，这里提供两种常用写法：

写法1：查询指定距离内的所有记录

import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.PagingAndSortingRepository;
import java.util.List;

public interface GeoTestRepository extends PagingAndSortingRepository<GeoTest, String> {

    /**
     * 查询指定点附近一定距离内的GeoTest记录
     * @param pointWKT 点的WKT格式字符串，比如"POINT(116.397228 39.9075)"（格式为：经度 纬度）
     * @param distanceInMeters 距离，单位：米
     * @return 符合条件的记录列表
     */
    @Query(value = "SELECT * FROM geo_test WHERE ST_DWithin(location, ST_GeomFromText(?1), ?2)", nativeQuery = true)
    List<GeoTest> findByLocationNear(String pointWKT, Double distanceInMeters);
}

写法2：查询带距离排序的结果

如果需要返回每个结果到指定点的距离并按距离排序，可以用这个写法：

@Query(value = "SELECT gt.*, ST_Distance_Sphere(gt.location, ST_GeomFromText(?1)) AS distance " +
               "FROM geo_test " +
               "WHERE ST_DWithin(gt.location, ST_GeomFromText(?1), ?2) " +
               "ORDER BY distance", nativeQuery = true)
List<Object[]> findByLocationNearWithDistance(String pointWKT, Double distanceInMeters);

调用后，返回的Object[]中第一个元素是GeoTest对象，第二个是距离值（Double类型）。

4. 调用示例 #

在业务代码中，你可以这样生成WKT格式的点并调用查询：

// 示例：查询北京天安门附近1000米内的记录
String pointWKT = "POINT(116.397228 39.9075)";
List<GeoTest> nearbyLocations = geoTestRepository.findByLocationNear(pointWKT, 1000.0);

注意事项 #

• 如果你的表用的是WGS84坐标系（SRID=4326），ST_DWithin默认单位是度，建议用ST_Distance_Sphere来直接计算球面距离（单位为米），避免单位转换错误。
• 记得给location字段创建空间索引，提升查询效率：

  CREATE SPATIAL INDEX idx_geo_test_location ON geo_test(location);
  

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