Spring调用仅需2参数的MariaDB存储过程却要求3参数问题排查

问题场景 #

使用Spring Boot 5.1.8搭配MariaDB 10.5.23时遇到以下问题：

• 定义StatisticsRepository继承JpaRepository，通过@Procedure注解调用存储过程getCampaignStatistics，方法接收guid和accountCode两个参数；
• MariaDB端的getCampaignStatistics存储过程仅包含p_Guid和p_AccountCode两个输入参数，命令行执行可正常返回结果集；
• Spring REST API调用该方法时返回NULL，日志显示Hibernate生成的调用语句为{call getCampaignStatistics(?,?,?)}，报错Parameter index of 3 is out of range (1, 2)。

疑问：

1. 为何Spring调用时要求3个参数？
2. 为何返回的CampaignStatisticModel始终为NULL？

问题原因及解决方案 #

1. 多参数问题的原因

Hibernate默认会把存储过程的结果集当作一个输出参数处理——JPA对存储过程的调用逻辑中，默认假设存储过程通过输出参数返回结果，而非直接返回查询结果集。当你的存储过程是直接返回结果集时，Hibernate会额外添加一个参数来接收“输出结果”，导致参数数量不匹配。

解决方法

• 显式指定存储过程的参数类型和结果集映射，避免Hibernate自动添加多余参数：
  1. 在@Procedure注解中明确指定参数名称，与存储过程的参数名严格对应：

     @Procedure(name = "getCampaignStatistics")
     CampaignStatisticModel getCampaignStatistics(
         @Param("p_Guid") String guid,
         @Param("p_AccountCode") String accountCode
     );
     

  2. 如果上述方法无效，可在实体类上用@NamedStoredProcedureQuery定义完整的存储过程映射，明确输入参数和结果集：

     @Entity
     @NamedStoredProcedureQuery(
         name = "getCampaignStatistics",
         procedureName = "getCampaignStatistics",
         parameters = {
             @StoredProcedureParameter(mode = ParameterMode.IN, name = "p_Guid", type = String.class),
             @StoredProcedureParameter(mode = ParameterMode.IN, name = "p_AccountCode", type = String.class)
         },
         resultClasses = CampaignStatisticModel.class
     )
     public class CampaignStatisticModel {
         // 实体字段定义
     }
     

     之后在Repository中直接调用该命名查询即可。

2. 返回NULL的原因

返回NULL是因为参数不匹配导致存储过程调用失败，Hibernate无法正确获取结果集，最终返回空对象。解决参数问题后，存储过程正常执行，结果集就能正确映射到CampaignStatisticModel中。

额外注意事项：

• 确保CampaignStatisticModel的字段与存储过程返回的结果集列名完全匹配（大小写敏感，可通过@Column注解指定列名）；
• 检查Spring Boot使用的数据库账号是否有执行该存储过程的权限。

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