【前端】异步任务风控验证与轮询机制技术方案（通用笔记版）

一、背景场景

在某类生成任务中，例如用户点击"执行任务"按钮后触发一个较耗时的后端操作（如生成报告、渲染图像、转码视频等），由于其调用了模型、渲染服务或需要较长处理时间，为了防止接口被频繁恶意调用，系统需要加入风控验证机制。

此外，因任务处理为异步，前端无法立即获得最终结果，因此需通过轮询方式定期查询任务状态，等待任务完成后展示结果。

二、整体流程说明

1. 用户点击"执行任务"按钮：

前端调用风控接口 /api/risk/check
若命中频控规则，弹出验证码组件（如滑块验证）
验证通过后继续发起任务请求
验证失败提示用户，保留输入内容并刷新验证组件

2. 验证通过后：

前端调用 /api/startTask 发起异步任务
后端返回任务ID taskId
前端开启轮询，请求 /api/task/status?taskId=xxx
当轮询返回 done，展示结果或跳转

三、技术方案模块拆解

1. 风控接口 `/api/risk/check`

用于检查当前用户/IP 是否触发频控策略
返回：是否需要验证、verifyToken（如需）

2. 验证模块

接入验证服务（滑块、人机验证）
验证成功后自动触发原始任务逻辑
验证失败刷新组件并提示用户

3. 任务发起接口 `/api/startTask`

发起耗时任务并返回 taskId
可附带验证 token（若有）

4. 轮询接口 `/api/task/status?taskId=xxx`

查询任务状态
典型状态值：pending, done, failed
建议每 2-3 秒轮询一次，限制最大轮询时长/次数

四、前端核心逻辑示意

ts 复制代码

async function handleExecute() {
  const riskRes = await fetch('/api/risk/check');

  if (riskRes.needVerify) {
    openVerifyModal(riskRes.verifyToken);
  } else {
    await startAndPollTask();
  }
}

async function onVerifySuccess(verifyToken) {
  await startAndPollTask(verifyToken);
}

async function startAndPollTask(verifyToken?) {
  const { taskId } = await fetch('/api/startTask', { body: { verifyToken } });
  const timer = setInterval(async () => {
    const res = await fetch(`/api/task/status?taskId=${taskId}`);
    if (res.status === 'done') {
      clearInterval(timer);
      renderResult(res.result);
    }
  }, 3000);
}

五、总结

阶段	是否需要轮询	原因
风控验证	❌ 不需要	验证同步完成
异步任务处理	✅ 需要	后端处理耗时，需等待任务完成

验证通过后只需继续执行原来的任务逻辑；轮询是异步任务必要的状态确认机制，不是风控逻辑的一部分。

该方案可复用于所有"异步任务 + 防滥用风控 + 前端轮询确认"的场景，如：内容生成、文件上传处理、智能翻译、AI摘要、渲染转码等任务链。