节点帮助

重试 Node.js（开发人员如何工作）

Name: IronPDF
Brand: Iron Software
Availability: InStock
Rating: 4.87 (307 reviews)

Darrius Serrant

2024年六月6日

在 Node.js 中，“retry”一词描述了一个模块，该模块由 Node.js 核心库提供，使得在操作失败后更容易重试操作。在管理网络请求或任何其他可能因网络错误或问题、服务器中断或超时等临时故障而失败的操作时，该模块尤其有用。

重试模块提供了一个多功能、可配置的 API，使重试不成功任务的过程变得更加容易。它使开发人员能够指定重试行为和策略，如重试次数、两次重试之间的间隔等待时间以及重试应在何种情况下进行。

瞬时生成 PDF 是动态在线开发世界的普遍需要。在创建发票、报告或认证时，Node.js 开发人员经常使用 IronPDF 等软件包。

然而，在实际情况中，由于网络问题、服务器故障或其他临时错误，可能会导致生成 PDF 的尝试不成功。在这种情况下，添加重试方法对于保证稳健性和可靠性至关重要。在本篇文章中，我们将探讨如何为 IronPDF 添加 User-Retry 模式，帮助 Node.js 开发人员提高 PDF 创建的可靠性。

了解用户重试模式

User-Retry 模式是软件开发中的一种弹性技术，用于处理操作过程中可能出现的临时问题，如网络请求或访问远程资源。它也被称为指数后退策略，或延迟不断增加的重试。这种模式对分布式系统特别有帮助，因为在分布式系统中，网络问题（如瞬间资源争用、服务器不可用响应数据或网络拥塞）等多种因素都可能导致故障。

User-Retry 如何工作

第一次尝试：进行了执行操作的尝试。如果翻译成功，业务将照常进行。另一方面，如果程序因临时错误而失败，重试机制将被激活。

重试并逐步增加延迟： 系统在重试失败的操作之前暂停一小段时间，而不是立即进行。每当您尝试重试时，重试延迟通常会变得更长。这种延迟减少了过度消耗资源的可能性，并使系统能够从临时问题中恢复。

指数退避: 这种方法中，每次重试尝试之间的间隔随着每次尝试呈指数增长，是一种计算重试延迟的流行方式。例如，延迟可能从几毫秒开始，每次尝试重试都会增加两毫秒。这种指数式增长可以使资源得到修复，并阻止系统不停地对其进行冲击。

最大重试次数：在操作成功或达到最大重试次数之前，重试过程将持续进行。例如，通过施加最大重试限制，您可以阻止系统执行过多请求并无休止地重试，否则会导致资源耗尽或停机时间延长。

使用 User-Retry 的好处

增强的弹性：在使用用户重试模式时，系统对临时错误的抵抗能力更强。他们不需要人工帮助，就能从挫折中优雅地恢复过来。

减少实现重试的负担：通过使用更长的重试间隔，减少了对目标资源的负担以及系统失败的尝试次数。这样可以提高系统的整体稳定性，降低出现连锁故障的可能性。

更快的恢复：通过逐步调整重试间隔，指数退避使系统能够更快地从临时问题中恢复。由于间隔时间较长，重试成功的几率增加，因此恢复速度更快。

改进的用户体验：在使用采用用户重试技术的应用程序时，用户会遇到更少的故障和延迟。通过对临时故障的透明管理，该系统可提供更加无缝和可靠的用户体验。

在 Node.js 中创建和使用重试

重试模块是 Node.js 的主要模块之一，它使在 Node.js 中开始重试任务变得简单。该模块通过简化重试逻辑的开发，使处理网络请求或其他异步进程中可能发生的临时故障变得更加容易。这是关于在 Node.js 中实现重试逻辑以及如何实现重试逻辑的详细教程：

安装 Node.js

如果您还没有安装 Node.js，可以从Node.js 官方网站下载并安装。

创建一个 Node.js 项目

使用终端或命令提示符，为您的项目创建一个新目录并在其中导航：

mkdir retry-example
cd retry-example

执行以下命令，创建一个全新的 Node.JSON 项目：

npm init -y

由此将产生一个软件包。项目目录中有一个 JSON 文件。

安装重试模块

无需单独安装重试模块，因为它已包含在 Node.JS 的核心库中。

实施重试逻辑

下面是一些示例 Node.js 代码的实现示例，向您展示如何使用重试模块构建重试逻辑。在本示例代码中，进行了一次等待时间 API 调用，如果由于临时错误而失败，则使用指数后退进行重试。

const retry = require('retry');
// Simulate a function that performs a network request with intermittent failures
function performNetworkRequest(callback) {
    // Simulate a network request that fails 50% of the time
    const success = Math.random() < 0.5;
    if (success) {
        callback(null, 'Request successful');
    } else {
        callback(new Error('Request failed'));
    }
}
// Define options for retrying the operation
const operationOptions = {
    retries: 3,             // Number of retry attempts
    factor: 2,              // Exponential backoff factor
    minTimeout: 1000,       // Initial retry delay in milliseconds
    maxTimeout: 60000,      // Maximum retry delay in milliseconds
    randomize: true         // Randomize retry delays
};
// Create a retry operation instance
const retryOperation = retry.operation(operationOptions);
// Execute the operation with retry logic
retryOperation.attempt(function(currentAttempt) {
    performNetworkRequest(function(err, result) {
        if (retryOperation.retry(err)) {
            // Retry the operation
            console.log(`Attempt ${currentAttempt}: Retrying operation...`);
            return;
        }
        // Operation succeeded or max retries reached
        if (err) {
            console.error('Operation failed after ' + currentAttempt + ' attempts:', err);
        } else {
            console.log('Operation succeeded:', result);
        }
    });
});

js

JAVASCRIPT

为了利用文件的功能，我们必须在开头加入重试模块。名为 performNetworkRequest 的模拟函数模拟了一个网络请求。它会随机失败 50%。重试操作的选择包含在 operationOptions 中。我们指定了最大和最小重试延迟、重试次数、指数后退因子以及是否随机重试延迟。

使用 retry.operation()，我们创建一个重试操作的实例，并将其传递给 operationOptions。我们在重试操作的尝试回调中使用了 performNetworkRequest 方法。如果请求失败且可以重试（如 retryOperation.retry(err) 所指示），我们会重试该操作。如果 retryoperation 对象是否有重试行为，我们将管理操作的成功或失败。

入门

就在 Python 网络应用程序中创建 PDF 而言，将 IronPDF 和 Celery 结合使用会相当有效。Celery 是一个分布式任务队列，能让您将耗时的任务从网络应用卸载到不同的工作进程中，而 IronPDF 则提供了创建、编辑和输出 PDF 文档的功能。通过异步创建 PDF，IronPDF 与 Celery 的集成有助于提高应用程序的可扩展性和性能。

什么是IronPDF？

我们可以使用流行的IronPDF Node.js 库在应用程序中创建、修改和呈现PDF文档。处理 PDF 的方式多种多样：您可以从 HTML 内容、照片或原始数据创建新的 PDF 文档；您还可以在现有网页中添加文本、图像和形状，从已有网页中提取文本和图像，并将 HTML 网页转换为 PDF。

IronPdf 的简单性和易用性是其两大优势。凭借其用户友好的 API 和丰富的文档，开发人员可以在其 Node.js JS 应用程序中快速开始生成 PDF。IronPdf 的效率和速度是帮助开发人员快速创建高质量 PDF 文档的又两大特点。

IronPDF 的几个优势：

根据 HTML、图片和原始数据制作 PDF。
删除 PDF 文件中的文本和图像。
在 PDF 文件中添加页眉、页脚和水印。
密码和加密用于保护 PDF 文件的安全。
能够以电子方式完成和签署文件。

安装 IronPDF

使用 pip 安装 IronPDF 库是第一步。

npm i @ironsoftware/ironpdf

导入和配置 IronPDF

IronPdf 库的安装必须先使用 npm 完成。在使用 IronPdf 制作 PDF 之前，您必须使用许可证密钥对其进行初始化。请确保您已准备好 IronPDF 许可证密钥。

const IronPdf = require("@ironsoftware/ironpdf");
var config=IronPdf.IronPdfGlobalConfig
config.setConfig({licenseKey:''});
const PdfDocument=IronPdf.PdfDocument;

js

JAVASCRIPT

定义 PDF 生成功能

然后，使用 IronPDF 定义 PDF 制作的功能。创建 PDF 的理由和解决任何潜在问题的完整代码应由该功能处理。

async function generatePdf(htmlContent) {
    try {
        const pdf = await PdfDocument.fromHtml(htmlContent);
        return pdf;
    } catch (error) {
        // Log or handle the error
        console.error("Error occurred during PDF generation:", error);
        throw error;
    }
}

js

JAVASCRIPT

实施重试逻辑

现在，集成重试逻辑来重试PDF 创建过程。

const retry = require('async-retry');
async function retryGeneratePdf(htmlContent) {
    return await retry(async (bail, attempt) => {
        console.log(`Attempt ${attempt} to generate PDF`);
        return await generatePdf(htmlContent);
    }, {
        retries: 3, // Maximum number of retry attempts
        factor: 2, // Exponential backoff factor
        minTimeout: 1000, // Initial retry delay in milliseconds
        maxTimeout: 60000, // Maximum retry delay in milliseconds
        randomize: true // Randomize retry delays
    });
}

js

JAVASCRIPT

使用重试逻辑生成 PDF

您现在可以使用 retryGeneratePdf 函数创建具有重试逻辑的 PDF。

const htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
retryGeneratePdf(htmlContent)
    .then(pdf => {
        // PDF generation succeeded
    await pdf.saveAs('output.pdf')
        console.log("PDF generated successfully");
        // Handle the generated PDF
    })
    .catch(error => {
        // PDF generation failed after retries
        console.error("Failed to generate PDF:", error);
    });