如何使用Spring Data JPA调用带默认参数的SQL Server存储过程无需传全参

根本原因 #

你遇到的报错本质是Hibernate 5.4及更早版本的默认行为限制：

• 处理存储过程调用时，默认采用按位置绑定参数的逻辑，忽略你定义的参数名，只会按参数注册顺序生成{call pHistory(?,?,?)}格式的调用语句
• 你的存储过程中@Model是第11个参数，按位置绑定的逻辑会把你传入的model值绑定到第2个参数位置（对应存储过程的@CarIds），最终触发参数索引越界或类型不匹配错误

可行解决方案 #

方案1：使用Spring JDBC SimpleJdbcCall（最稳定推荐） #

不需要修改数据库，也不依赖Hibernate版本，Spring原生封装支持命名参数调用，自动适配SQL Server存储过程的可选默认参数：

@Repository
public class CarHistoryRepository {
    @Autowired
    private JdbcTemplate jdbcTemplate;

    public Blob getCarData(String model, String make) {
        // 初始化存储过程调用对象，自动适配命名参数
        SimpleJdbcCall jdbcCall = new SimpleJdbcCall(jdbcTemplate)
                .withProcedureName("pHistory")
                .declareParameters(
                        new SqlOutParameter("@CarData", Types.BLOB),
                        new SqlParameter("@Model", Types.NVARCHAR),
                        new SqlParameter("@Make", Types.NVARCHAR)
                );
        // 仅传入需要的IN参数
        Map<String, Object> paramMap = Map.of(
                "@Model", model,
                "@Make", make
        );
        // 执行调用并获取OUT参数返回值
        Map<String, Object> result = jdbcCall.execute(paramMap);
        return (Blob) result.get("@CarData");
    }
}

方案2：升级Hibernate版本 + 开启命名参数配置 #

如果要继续使用JPA StoredProcedureQuery 或 @Procedure 注解，将Hibernate版本升级到5.5+，并在application配置中开启存储过程命名参数传递：

• Spring Boot YAML配置示例：

spring:
  jpa:
    properties:
      hibernate:
        proc:
          param_name_passing_enabled: true

配置开启后，Hibernate会生成带命名参数的调用语句，自动匹配你定义的参数名，不需要传入所有带默认值的可选参数。

方案3：使用@Query原生查询 #

如果不想引入JDBC相关依赖，也可以直接写原生EXEC语句，Spring Data JPA直接支持：

public interface CarRepository extends Repository<Car, Long> {
    @Query(value = """
        DECLARE @CarData varbinary(max);
        EXEC pHistory @CarData = @CarData OUT, @Model = :model, @Make = :make;
        SELECT @CarData;
        """, nativeQuery = true)
    byte[] getCarData(@Param("model") String model, @Param("make") String make);
}

注意这里返回值直接用byte[]比Blob类型更易用，不需要额外处理Blob序列化问题。

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