1. IronPDF for Node.js
  2. IronPDF for Node.js博客
  3. 节点帮助
  4. 重试 Node.js
节点帮助

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

发布 2024年六月6日
分享:

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

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

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

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

了解用户重试模式

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

User-Retry 如何工作

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

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

指数回溯： 这种方法是计算重试延迟的常用方法，每次重试尝试之间的间隔时间以指数形式增加。 例如，延迟可能从几毫秒开始，每次尝试重试都会增加两毫秒。 这种指数式增长可以使资源得到修复，并阻止系统不停地对其进行冲击。

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

使用 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
mkdir retry-example
cd retry-example
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'mkdir retry-example cd retry-example
VB   C#

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

npm init -y
npm init -y
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'npm init -y
VB   C#

由此将产生一个软件包。 项目目录中有一个 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);
        }
    });
});
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);
        }
    });
});
Private const retry = require( 'retry');
' Simulate a function that performs a network request with intermittent failures
Private Function performNetworkRequest(ByVal As callback) As [function]
	' Simulate a network request that fails 50% of the time
	const success = Math.random() < 0.5
	If success Then
		callback(Nothing, 'Request successful');
	Else
		callback(New [Error]( 'Request failed'));
	End If
End Function
' Define options for retrying the operation
Private const operationOptions = { retries: 3, factor: 2, minTimeout: 1000, maxTimeout: 60000, randomize: True }
' Create a retry operation instance
Private const retryOperation = retry.operation(operationOptions)
' Execute the operation with retry logic
retryOperation.attempt([function](currentAttempt) { performNetworkRequest([function](err, result) { if(retryOperation.retry(err)) { console.log(`Attempt ${currentAttempt}:= Retrying operation...`); Return; } if(err) { console.error( 'Operation failed after ' + currentAttempt + ' attempts:', err); } else { console.log('Operation succeeded:', result); } }); });
VB   C#

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

使用 retry.operation()现在，我们创建一个重试操作实例，并向其提供 operationOptions。 我们在重试操作的尝试回调中使用了 performNetworkRequest 方法。 如果请求失败且可重试，我们将重试操作(所示，retryOperation.retry(打错)). 如果 retryoperation 对象是否有重试行为，我们将管理操作的成功或失败。

入门

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

什么是IronPDF？

我们可以在应用程序中创建、修改和渲染 PDF 文档，使用流行的IronPDF Node.js 库. 处理 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
npm i @ironsoftware/ironpdf
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'npm i @ironsoftware/ironpdf
VB   C#

导入和配置 IronPDF

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

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

定义 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;
    }
}
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;
    }
}
Async Function generatePdf(ByVal As htmlContent) As [function]
	Try
		const pdf = Await PdfDocument.fromHtml(htmlContent)
		Return pdf
	Catch e1 As [error]
		' Log or handle the error
		console.error("Error occurred during PDF generation:", [error])
		Throw [error]
	End Try
End Function
VB   C#

实施重试逻辑

现在，加入重试逻辑以重试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
    });
}
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
    });
}
Private const retry = require( 'async-retry');
Async Function retryGeneratePdf(ByVal As htmlContent) As [function]
	Return Await retry(Async Function(bail, attempt)
		console.log(`Attempt ${attempt} [to] generate PDF`)
		Return Await generatePdf(htmlContent)
	End Function,{
		retries:=3,
		factor:= 2,
		minTimeout:= 1000,
		maxTimeout:= 60000,
		randomize:= True
	})
End Function
VB   C#

使用重试逻辑生成 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);
    });
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);
    });
Private const htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>"
'INSTANT VB WARNING: The following constructor is declared outside of its associated class:
'ORIGINAL LINE: retryGeneratePdf(htmlContent).then(pdf =>
Private Sub New()
	Await pdf.saveAs( 'output.pdf') console.log("PDF generated successfully");
End Sub
'INSTANT VB TODO TASK: Lambda expressions and anonymous methods are not converted by Instant VB if local variables of the outer method are referenced within the anonymous method:
).catch([error] =>
VB   C#

自定义重试逻辑： 您可以更改重试策略或处理重试逻辑中的特定问题，以满足您的需求。

错误处理： 为解决在创建 PDF 或重试过程中出现的错误，应实施适当的错误处理。

日志记录： 包括日志记录，以便跟踪故障和重试，用于监控和调试。

通过将 IronPDF 与重试逻辑集成，您可以在 Node.js 应用程序中提高可靠性并优雅地处理 PDF 创建错误。

重试 Node.js（如何为开发人员工作）：图 1

结论

总而言之，将 IronPDF 与 Node.js 中的重试逻辑相结合，为在线应用程序生成 PDF 提供了一种坚实可靠的方法。通过使用诸如 sync-retry 等库以及 IronPDF 用于 PDF 创建和操作的强大功能，开发人员可以确保涉及生成 PDF 的流程能够抵御临时错误和网络问题。

当 IronPDF 和重试逻辑相结合时，应用程序可以在 PDF 生成过程中通过自动重试操作以增加延迟来优雅地容忍故障。 这样，即使在网络不畅或流量较大的情况下，涉及创建 PDF 的任务也有可能有效完成。

IronPdf 作为包含终身许可证的套餐，价格实惠。 该软件包具有极高的价值，许多系统的价格仅为 749 美元。 它为许可证持有者提供全天候在线工程支持。 请访问定价信息页面了解更多收费信息。 参观铁软件了解有关 Iron Software 产品的更多信息。

< 前一页
Axios Retry NPM（它如何为开发者工作）
下一步 >
JavaScript 等待5秒（开发人员如何使用）

使用 npm 安装

版本：2024.11

> npm i @ironsoftware/ironpdf

报告问题

准备开始了吗？ 版本： 2024.11 刚刚发布

免费 npm 安装 查看许可证 >