Spring Boot异步调用存储过程报错，如何实现无等待执行？

核心问题原因 #

1. 手动线程调用报错：你的runStoredProcedure是private方法，Spring的@Transactional注解对private方法无效（Spring AOP基于代理实现，无法拦截private方法），导致存储过程执行时没有正确的数据库连接/事务上下文，执行后连接被提前回收，无法读取OUT参数p_return_code，从而抛出异常。
2. @Async不生效：同样因为@Async加在private方法上，Spring无法生成异步代理，调用始终是同步执行。

正确实现步骤 #

1. 提取异步方法到独立的Spring Bean #

将存储过程调用逻辑移到一个public的Spring Bean方法中，并添加@Async和@Transactional注解：

@Service
public class AsyncStoredProcedureService {

    private final UploadInstanceRepository uploadInstanceRepository;

    // 构造注入（推荐）
    public AsyncStoredProcedureService(UploadInstanceRepository uploadInstanceRepository) {
        this.uploadInstanceRepository = uploadInstanceRepository;
    }

    @Async
    @Transactional
    public void runFileUploadAsync(UploadInstanceEntity uploadInstance, FileReport fileReport) {
        Map<String, Object> result = uploadInstanceRepository.fileUpload("CPI", uploadInstance.getId());
        // 可在这里添加结果日志、后续处理逻辑
    }
}

2. 开启Spring异步支持 #

在你的Spring Boot启动类上添加@EnableAsync注解：

@SpringBootApplication
@EnableAsync
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

3. 调用异步方法 #

在原来的业务类中注入上面的Service，直接调用异步方法即可，调用方无需等待：

@Service
public class YourBusinessService {

    private final AsyncStoredProcedureService asyncService;

    public YourBusinessService(AsyncStoredProcedureService asyncService) {
        this.asyncService = asyncService;
    }

    public void yourOriginalMethod(UploadInstanceEntity uploadInstance, FileReport fileReport) {
        // 其他业务逻辑...

        // 异步调用存储过程，立即返回
        asyncService.runFileUploadAsync(uploadInstance, fileReport);

        // 直接继续后续逻辑或返回，无需等待存储过程执行完成
    }
}

关键注意事项 #

• Spring的@Transactional和@Async仅对public方法生效，因为Spring需要通过代理类拦截方法调用实现功能，private方法无法被代理。
• 不要手动创建Thread或CompletableFuture来执行事务方法，Spring的@Async会帮你管理线程池和事务上下文，避免连接/参数异常。
• 如果需要获取异步执行的结果，可以将方法返回值改为CompletableFuture<Map<String, Object>>，但根据你的需求，返回void即可满足无等待的要求。

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