使用Spring JPA映射SQL Server存储过程结果集至实体/POJO遇SQLGrammarException

核心问题定位 #

报错提示Incorrect syntax near '.'，结合你使用的SQL Server环境，核心原因是Spring JPA生成的存储过程调用语法不符合SQL Server规范，或者存储过程的引用格式被解析错误。

具体解决步骤 #

1. 修正存储过程的引用格式 #

SQL Server中带架构的存储过程必须用[架构名].[存储过程名]的格式引用，直接写Car.GetUsersByCity会导致Hibernate错误解析点号。调整仓库接口的注解：

@Repository
public interface CarRepository extends JpaRepository<Car, Integer> {
    @Procedure(procedureName = "[Car].[GetUsersByCity]")
    List<Car> getAllCars(@Param("cityName") String city, @Param("countryName") String country);
}

注意：不要用Object[]作为返回类型，直接指定实体类的List，JPA会自动映射结果集。

2. 显式绑定实体类与存储过程（更可靠） #

在Car实体类上添加@NamedStoredProcedureQuery，明确定义存储过程的参数、结果映射规则，避免JPA解析歧义：

@Entity
@NamedStoredProcedureQuery(
    name = "Car.GetUsersByCity",
    procedureName = "[Car].[GetUsersByCity]",
    parameters = {
        @StoredProcedureParameter(mode = ParameterMode.IN, name = "cityName", type = String.class),
        @StoredProcedureParameter(mode = ParameterMode.IN, name = "countryName", type = String.class)
    },
    resultClasses = Car.class
)
public class Car {
    // 实体类原有字段及注解
}

对应的仓库接口方法保持简洁：

@Procedure(name = "Car.GetUsersByCity")
List<Car> getAllCars(@Param("cityName") String city, @Param("countryName") String country);

3. 验证生成的SQL语句 #

开启Hibernate SQL日志，查看实际生成的调用语句是否符合SQL Server规范：
在application.properties中添加配置：

logging.level.org.hibernate.SQL=DEBUG
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE

正常的SQL Server存储过程调用应该是：

exec [Car].[GetUsersByCity] @cityName=?, @countryName=?

如果生成的是call Car.GetUsersByCity(?, ?)（MySQL语法），说明JPA方言配置错误，需确保使用SQL Server方言：

spring.jpa.database-platform=org.hibernate.dialect.SQLServer2012Dialect

4. 确保结果集与实体类字段匹配 #

存储过程返回的结果集列名必须和Car实体类的字段名（或@Column注解指定的列名）完全一致。如果列名不匹配，可在存储过程中给列加别名，或在实体类中用@Column(name = "数据库列名")指定映射关系。

5. 备选方案：手动调用存储过程 #

如果上述方式仍有问题，直接用EntityManager手动调用，灵活性更高：

@Repository
public class CarCustomRepository {
    @PersistenceContext
    private EntityManager entityManager;

    public List<Car> getAllCars(String city, String country) {
        StoredProcedureQuery query = entityManager.createStoredProcedureQuery("[Car].[GetUsersByCity]", Car.class);
        query.registerStoredProcedureParameter("cityName", String.class, ParameterMode.IN);
        query.registerStoredProcedureParameter("countryName", String.class, ParameterMode.IN);
        query.setParameter("cityName", city);
        query.setParameter("countryName", country);
        return query.getResultList();
    }
}

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