Spring Data JPA调用无输入参数、多输出参数Oracle存储过程时出现位置参数异常求助

这个问题的核心是Spring Data JPA在处理无输入参数、仅输出参数的存储过程时，Hibernate的参数解析逻辑会默认尝试按位置匹配参数，忽略了我们指定的名称映射规则，最终抛出位置参数未注册的异常。下面提供两种可行的解决办法：

方法1：调整Spring Data JPA注解配置，强制按名称绑定参数 #

首先检查并修正你的注解配置，确保名称匹配规则统一（Oracle数据库对象名称默认是大写，建议配置时统一使用大写）：

修改后的实体类注解 #

@Entity
@Table(name = "TABLE_NAME")
@NamedStoredProcedureQueries({
    @NamedStoredProcedureQuery(
        name = "MYPACKAGE.SPNAME", // 和存储过程完整名称完全一致，统一大写
        procedureName = "MYPACKAGE.SPNAME", // 数据库中实际的存储过程名（包名+过程名）
        parameters = {
            @StoredProcedureParameter(mode = ParameterMode.OUT, name = "PO_VALUE1", type = String.class),
            @StoredProcedureParameter(mode = ParameterMode.OUT, name = "PO_VALUE2", type = String.class),
            @StoredProcedureParameter(mode = ParameterMode.OUT, name = "PO_VALUE3", type = String.class),
            @StoredProcedureParameter(mode = ParameterMode.OUT, name = "PO_VALUE4", type = String.class)
        })
})
public class Tablename {
    // 省略属性...
}

修改后的Repository接口 #

@Repository
public interface TableNameRepository extends JpaRepository<TableName, Long> {
    @Procedure(name = "MYPACKAGE.SPNAME") // 和@NamedStoredProcedureQuery的name完全匹配
    Map<String, Object> callSpName(); // 自定义方法名，避免和存储过程名冲突
}

这种方式通过统一名称大小写，让Spring Data能正确关联参数映射，但部分版本的Spring Data/Hibernate仍可能存在纯OUT参数的解析问题，这时可以尝试更稳定的第二种方法。

方法2：使用EntityManager手动调用存储过程（推荐） #

绕过Spring Data的自动解析逻辑，直接通过EntityManager与Hibernate底层API交互，精准控制参数绑定：

@Service
public class YourService {

    @PersistenceContext
    private EntityManager entityManager;

    public Map<String, String> getStoredProcedureResult() {
        Map<String, String> resultMap = new HashMap<>();

        // 创建存储过程查询对象
        StoredProcedureQuery procedureQuery = entityManager.createStoredProcedureQuery("MYPACKAGE.SPNAME");
        
        // 逐个注册OUT参数
        procedureQuery.registerStoredProcedureParameter("PO_VALUE1", String.class, ParameterMode.OUT);
        procedureQuery.registerStoredProcedureParameter("PO_VALUE2", String.class, ParameterMode.OUT);
        procedureQuery.registerStoredProcedureParameter("PO_VALUE3", String.class, ParameterMode.OUT);
        procedureQuery.registerStoredProcedureParameter("PO_VALUE4", String.class, ParameterMode.OUT);
        
        // 执行存储过程
        procedureQuery.execute();
        
        // 提取输出参数值
        resultMap.put("PO_VALUE1", (String) procedureQuery.getOutputParameterValue("PO_VALUE1"));
        resultMap.put("PO_VALUE2", (String) procedureQuery.getOutputParameterValue("PO_VALUE2"));
        resultMap.put("PO_VALUE3", (String) procedureQuery.getOutputParameterValue("PO_VALUE3"));
        resultMap.put("PO_VALUE4", (String) procedureQuery.getOutputParameterValue("PO_VALUE4"));
        
        return resultMap;
    }
}

这种方式完全避免了Spring Data的参数映射冲突，稳定性更高，尤其适合纯OUT参数的特殊场景。

问题原因补充 #

出现Positional parameter [1] is not registered异常，是因为Hibernate在处理无输入参数的存储过程时，会默认尝试按位置去获取输出参数，但我们的配置是按名称绑定的，导致位置参数找不到对应的注册项。通过手动注册参数或调整注解的名称匹配规则，就能解决这个冲突。

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