本文旨在指导开发者如何使用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()方法处理失败情况，打印错误信息。
注意事项
- API Key: 在示例代码中，请务必将YOUR_API_KEY替换为您自己的API Key。
- 错误处理： 在实际项目中，需要更完善的错误处理机制，例如记录错误日志、通知管理员等。
- 幂等性： 确保你的API请求是幂等的，即多次执行相同的请求应该产生相同的结果。如果API不是幂等的，重试可能会导致意外的副作用。
- 重试策略： 可以根据实际情况调整最大重试次数和重试间隔时间。例如，可以采用指数退避策略，即每次重试时，重试间隔时间都会增加。
- 条件判断： condition函数应该足够健壮，能够处理各种可能的响应情况，避免出现意外的错误。
- 避免无限循环： 设置最大重试次数是避免无限循环的关键。
总结
通过封装一个可复用的重试函数，可以有效地处理需要重试的API调用场景，提高应用程序的稳定性和可靠性。在实际项目中，可以根据具体需求调整重试策略和错误处理机制，以满足不同的业务场景。 本教程提供了一个基础的实现示例，您可以根据实际情况进行扩展和优化。
立即学习“Java免费学习笔记（深入）”；
