深入详解SpringBoot中接口异步化实战指南

package org.jeecg.modules.business.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.EnableAsync;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;

import java.util.concurrent.Executor;
import java.util.concurrent.ThreadPoolExecutor;

/**
 * @author lxy
 */
@Configuration
@EnableAsync  // 开启 Spring 异步支持
public class AsyncConfig {

    /**
     * 生成讲稿专用异步线程池。
     * AI 调用属于 IO 密集型，核心线程数不需要很大。
     * 使用 CallerRunsPolicy 作为拒绝策略，保证任务不丢失。
     */
    @Bean("speechExecutor")
    public Executor speechExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setCorePoolSize(2);       // 核心线程数
        executor.setMaxPoolSize(5);        // 最大线程数
        executor.setQueueCapacity(20);     // 队列容量
        executor.setThreadNamePrefix("speech-async-");
        executor.setKeepAliveSeconds(60);
        // 队列满且线程达到上限时，由调用方线程执行，避免任务丢失
        executor.setRejectedExecutionHandler(new ThreadPoolExecutor.CallerRunsPolicy());
        executor.initialize();
        return executor;
    }
}

/**
 * 异步生成讲稿。方法立即返回，由后台线程池（speechExecutor）执行耗时的 AI 调用。
 * 生成成功后自动将 cdGenStatus 更新为"讲稿已生成"（2），
 * 生成失败则回滚为"暂存"（0），无需前端二次调用更新状态接口。
 *
 * @param speechDto 生成讲稿所需参数，包含 courseDetailId、classId 等
 */
@Async("speechExecutor")  // 指定使用 speechExecutor 线程池
@Override
public void generateSpeech(SpeechDto speechDto) {
    try {
        // --- 耗时操作：调用 AI 大模型 ---
        String genWord = cozeUtil.pptCreate(cozeDto);

        // 其他业务逻辑...

        // 生成成功 → 后端直接更新状态为"已生成"
        this.updateCdGenStatus("2", speechDto.getCourseDetailId(), speechDto.getClassId());

    } catch (Exception e) {
        // 生成失败 → 回滚状态为"暂存"，前端可重试
        this.updateCdGenStatus("0", speechDto.getCourseDetailId(), speechDto.getClassId());
        throw new RuntimeException(e);
    }
}

@PostMapping(value = "/generateSpeech")
public Result<?> generateSpeech(@RequestBody SpeechDto speechDto) {
    bizCourseDetailService.generateSpeech(speechDto);  // 立即返回
    return Result.OK();
}

// ❌ 错误：在同一个 Service 内部调用，@Async 不生效
public void someMethod() {
    this.generateSpeech(dto);  // 直接调用，不走代理，不会异步
}

// ✅ 正确：从另一个 Spring Bean（如 Controller）注入后调用
@Autowired
private IBizCourseDetailService bizCourseDetailService;

public void someMethod() {
    bizCourseDetailService.generateSpeech(dto);  // 走代理，异步生效
}

// 调用生成讲稿接口后，定时轮询状态
async function generateSpeech(params) {
  await api.generateSpeech(params);  // 立即返回

  // 轮询，每 3 秒检查一次
  const timer = setInterval(async () => {
    const res = await api.queryCourseDetail({ id: params.courseDetailId, classId: params.classId });
    const status = res.result.cdGenStatus;
    if (status === '2') {
      clearInterval(timer);
      // 生成成功，刷新页面
    } else if (status === '0') {
      clearInterval(timer);
      // 生成失败，提示用户重试
    }
  }, 3000);
}