调用存储过程时@Transactional的必填场景及差异原因解析

问题背景 #

我有如下SQL Server存储过程：

procedure [dbo].[perf] (
  @endDate date,
  @startDate date,
  @productName varchar(20),
  @endPrice decimal(10,2) output,
  @startPrice decimal(10,2) output,
  @startEv decimal(10,3) output,
  @endEv decimal(10,3) output) as 

BEGIN 

--TSQL code

END

当我不带@Transactional调用如下Spring Data Repository方法时：

public interface PriceRepository extends Repository<Price, Long> {

    @Procedure(name = "Price.perf")
    Map<String, Object> getStartPrice(@Param("endDate") LocalDate endDate, @Param("startDate") LocalDate startDate, @Param("productName") String productName);
    
}

会触发如下错误：

org.springframework.dao.InvalidDataAccessApiUsageException: OUT/INOUT parameter not available: endPrice

给getStartPrice方法添加@Transactional注解后就能正常运行。请问调用存储过程时，何时需要添加@Transactional？

补充观察 #

看起来所有存储过程调用都需要@Transactional，但根据存储过程的结尾逻辑，注解的位置要求还有差异：

情况1：存储过程以return结尾 #

procedure [dbo].[perf] (
  @endDate date,
  @startDate date,
  @productName varchar(20),
  @endPrice decimal(10,2) output,
  @startPrice decimal(10,2) output,
  @startEv decimal(10,3) output,
  @endEv decimal(10,3) output) as 

BEGIN 

--TSQL code
  
  return
END

此时@Transactional可以直接加在Repository方法上，否则会出现上述的OUT/INOUT parameter not available错误。

情况2：存储过程以select结尾 #

procedure [dbo].[perf] (
  @endDate date,
  @startDate date,
  @productName varchar(20),
  @endPrice decimal(10,2) output,
  @startPrice decimal(10,2) output,
  @startEv decimal(10,3) output,
  @endEv decimal(10,3) output) as 

BEGIN 

--TSQL code
  
  select * from someTable;
END

此时必须在调用Repository方法的上层方法添加@Transactional，否则会触发更明确的错误：

Caused by: org.springframework.dao.InvalidDataAccessApiUsageException:
You're trying to execute a @Procedure method without a surrounding transaction that keeps the connection open so that the ResultSet can actually be consumed; Make sure the consumer code uses @Transactional or any other way of declaring a (read-only) transaction

为什么存储过程的结尾逻辑不同，@Transactional的使用要求会有差异？

解答 #

核心原因：数据库连接的生命周期与资源获取时机 #

Spring Data在处理存储过程调用时，连接的管理逻辑取决于存储过程的输出类型：

1. 仅含OUT参数、无ResultSet返回（return结尾）
   当存储过程仅通过OUT参数返回数据、没有ResultSet输出时，Spring需要在存储过程执行完成后，从数据库连接中提取OUT参数的值。如果没有事务，Spring会在执行完存储过程后立即关闭连接，导致无法读取OUT参数——这就是出现OUT/INOUT parameter not available错误的原因。

将@Transactional加在Repository方法上时，事务会保持连接打开，直到方法执行完成，Spring可以顺利读取所有OUT参数后再关闭连接。

2. 含ResultSet输出（select结尾）
   当存储过程最后执行select返回ResultSet时，Spring对ResultSet的读取是延迟加载的：调用Repository方法时，Spring仅执行存储过程并获取ResultSet的引用，实际数据读取是在后续遍历结果时才进行。

如果@Transactional仅加在Repository方法上，方法执行完成后事务就会提交，连接被关闭，此时再去读取ResultSet就会报错。因此必须将事务放在上层调用方法上，确保在整个ResultSet消费过程中（比如Service层遍历结果的阶段）连接始终保持打开状态。

总结：何时需要@Transactional？ #

• 只要存储过程包含OUT/INOUT参数，或者会返回ResultSet，就必须开启事务，确保数据库连接在所有数据读取操作完成前不被关闭。
• 具体注解位置：
  • 仅含OUT参数、无ResultSet：可直接加在Repository方法上
  • 有ResultSet返回：必须加在Repository方法的上层调用者（如Service层方法）上，保证ResultSet消费阶段连接有效

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