当前位置：首页 > 文章列表 > 文章 > 前端 > 自动重试API请求方法全解析

自动重试API请求方法全解析

2025-09-29 22:57:32 0浏览收藏

最近发现不少小伙伴都对文章很感兴趣，所以今天继续给大家介绍文章相关的知识，本文《自动重试API请求方法详解》主要内容涉及到等等知识点，希望能帮到你！当然如果阅读本文时存在不同想法，可以在评论中表达，但是请勿使用过激的措辞~

自动重试API请求直至满足条件：JavaScript实现指南

本文旨在指导开发者如何使用JavaScript实现API请求的自动重试机制，直到API响应中的特定值满足预设条件。我们将以axios库为例，展示如何封装一个可复用的重试函数，并提供详细的代码示例和注意事项，帮助您在实际项目中高效地处理需要重试的API调用场景。

实现思路

核心思路是创建一个递归函数，该函数会不断地发起API请求，直到满足特定条件（例如，API响应中的status字段等于"done"）。每次请求后，检查响应结果。如果满足条件，则停止重试并执行后续操作；否则，继续发起请求。为了避免无限循环，可以设置最大重试次数。

代码实现

以下是一个使用axios库实现的重试函数的示例：

const axios = require("axios");
const qs = require("qs");

// 示例API配置
let data = qs.stringify({
  document_key: "038A2E0792CE72020E9BB88380D002EB582A6B3AE5883C34DE53C9F17D415D99",
});

let config = {
  method: "post",
  maxBodyLength: Infinity,
  url: "https://api-free.deepl.com/v2/document/95BA71197AC66EE4745FF5269CF4399D",
  headers: {
    Authorization: 'YOUR_API_KEY', // 替换为你的API Key
    "Content-Type": "application/x-www-form-urlencoded",
  },
  data: data,
};


/**
 * 自动重试API请求，直到满足条件
 * @param {object} config axios配置对象
 * @param {function} condition 检查响应是否满足条件的函数 (response) => boolean
 * @param {number} maxRetries 最大重试次数，默认为5
 * @param {number} delay 重试间隔时间（毫秒），默认为1000
 * @returns {Promise<any>} Promise，resolve为满足条件的响应数据，reject为达到最大重试次数或发生其他错误
 */
async function retryUntilSuccess(config, condition, maxRetries = 5, delay = 1000) {
  let attempts = 0;

  while (attempts < maxRetries) {
    try {
      const response = await axios.request(config);
      if (condition(response)) {
        return response.data; // 返回满足条件的响应数据
      } else {
        console.log(`Attempt ${attempts + 1} failed. Retrying in ${delay}ms...`);
        await new Promise(resolve => setTimeout(resolve, delay)); // 延迟一段时间后重试
        attempts++;
      }
    } catch (error) {
      console.error(`Attempt ${attempts + 1} failed with error: ${error.message}`);
      if (attempts < maxRetries - 1) {
        console.log(`Retrying in ${delay}ms...`);
        await new Promise(resolve => setTimeout(resolve, delay)); // 延迟一段时间后重试
        attempts++;
      } else {
        throw new Error(`Max retries reached. Last error: ${error.message}`); // 达到最大重试次数，抛出错误
      }
    }
  }

  throw new Error("Max retries reached without success."); // 达到最大重试次数，抛出错误
}

// 使用示例
retryUntilSuccess(
  config,
  (response) => response.data.status === "done",
  10, // 最大重试次数
  2000 // 重试间隔2秒
)
  .then((data) => {
    console.log("API call successful with status 'done':", data);
  })
  .catch((error) => {
    console.error("API call failed:", error.message);
  });

代码解释

retryUntilSuccess(config, condition, maxRetries = 5, delay = 1000) 函数：
- config：axios配置对象，包含请求方法、URL、Headers等信息。
- condition：一个函数，用于检查API响应是否满足条件。它接收axios的响应对象作为参数，并返回一个布尔值。
- maxRetries：最大重试次数，默认为5次。
- delay：重试间隔时间，单位为毫秒，默认为1000毫秒（1秒）。
重试逻辑：
- 使用while循环进行重试，直到达到最大重试次数。
- 每次循环中，使用axios.request(config)发起API请求。
- 如果请求成功，调用condition函数检查响应是否满足条件。
- 如果满足条件，则resolve Promise，返回响应数据。
- 如果不满足条件，则使用setTimeout函数延迟一段时间后重试。
- 如果请求失败，捕获错误并打印错误信息。如果未达到最大重试次数，则延迟一段时间后重试；否则，reject Promise，抛出错误。
使用示例：
- 调用retryUntilSuccess函数，传入axios配置对象、检查响应的函数、最大重试次数和重试间隔时间。
- 使用.then()方法处理成功情况，打印响应数据。
- 使用.catch()方法处理失败情况，打印错误信息。