Node.js 中 HTTP 请求的错误处理和重试方法-JavaScript中文网-JavaScript教程资源分享门户

随着现代 Web 应用的不断发展，Node.js 的地位变得越来越重要。Node.js 在作为前端开发中的重要工具之一，通过提供 HTTP 客户端 API，可以方便地和服务端通讯，进而实现一些强大的功能。但是在实际使用过程中，我们也经常会遇到 HTTP 请求出现错误的情况，本文将介绍如何在 Node.js 中正确处理 HTTP 请求的错误并进行重试。

HTTP 错误状态码

在发起 HTTP 请求时，通常会通过获取响应的状态码来判断请求的结果是否成功。常见的 HTTP 状态码包括：

200 OK：请求成功，对应的请求结果数据在响应体中
400 Bad Request：请求不合法，比如 URL 错误、数据格式错误等
401 Unauthorized：未授权，需要登录或者提供合法的认证信息
403 Forbidden：禁止访问，服务器理解请求，但拒绝提供服务。通常会包含原因字符串，供开发者参考。
404 Not Found：未找到资源，通常是 URL 和资源路径不匹配引起的
500 Internal Server Error：服务器错误，通常是服务器内部错误导致的

更多状态码的详细解释和用法可以参考 MDN 文档。

错误处理方法

在实际项目中，我们通常会使用 Node.js 中的 http 模块发起 HTTP 请求。在使用时，常常会遇到连接错误、超时等各种错误，正常的 HTTP 状态码无法提供足够的信息。为此，我们通常可以结合 Node.js 提供的错误机制来进行处理。

下面是一个简单的 GET 请求的示例：

// www.javascriptcn.com code example
const http = require('http');

const options = {
  hostname: 'api.github.com',
  port: 443,
  path: '/users/github',
  method: 'GET'
};

const req = http.request(options, (res) => {
  console.log(`STATUS: ${res.statusCode}`);
  console.log(`HEADERS: ${JSON.stringify(res.headers)}`);
  res.setEncoding('utf8');
  res.on('data', (chunk) => {
    console.log(`BODY: ${chunk}`);
  });
});

req.on('error', (e) => {
  console.error(`请求遇到问题: ${e.message}`);
});

req.end();

在上述代码中，我们通过 http 模块的 request 方法创建了一个 HTTP 请求实例，并通过监听 request 实例的 error 事件来处理请求遇到问题的情况。

比如，在请求时可能会发生连接错误等问题，我们可以通过监听 error 事件并输出错误信息：

req.on('error', (e) => {
  console.error(`请求遇到问题: ${e.message}`);
});

对于具体的错误类型，我们可以通过 e.code 和 e.message 等属性来获取。

比如，当请求超时时，我们可以通过在请求实例上设置 timeout 来控制超时时间，并在超时后输出错误信息：

req.setTimeout(5000, () => {
  req.abort();
  console.error(`请求超时: ${options.hostname}`);
});

req.on('error', (e) => {
  console.error(`请求遇到问题: ${e.message}`);
});

在请求超时时，我们通过调用 req.abort() 中断请求，并输出错误信息。

如果错误类型属于网络错误，我们可以将错误类型设置为 ECONNREFUSED （连接被拒绝）、ECONNRESET （连接被重置）等。这些错误类型可以帮助我们更好地排查问题。

重试方案

在实际应用中，HTTP 请求遇到错误时重试是一种非常常见的做法，可以帮助我们尽可能地确保数据的完整性和可靠性。但是，在进行重试时还需要注意一些问题。

首先，我们需要注重重试间隔的设置，避免在网络不佳的情况下造成服务器过载，而又不会导致请求等待时间过长。通常可以在重试时添加随机间隔，避免重试间隔一致时造成的过载问题。

另外，我们还需要考虑最大重试次数等事项。过多的重试可能会导致请求超时或者浪费服务器资源，需要根据实际情况进行调整。

下面是一个简单的带有重试机制的 HTTP 请求示例代码：

// www.javascriptcn.com code example
const http = require('http');

const options = {
  hostname: 'api.github.com',
  port: 443,
  path: '/users/github',
  method: 'GET',
};

const retry = 3;
let retryCount = 0;

function requestData() {
  const req = http.request(options, (res) => {
    res.on('data', (data) => {
      console.log(Buffer.from(data).toString());
    });
    res.on('end', () => {
      console.log('请求已经完成。');
    });
  });

  req.setTimeout(5000, () => {
    req.abort();
    console.error(`请求超时: ${options.hostname}`);
    if (retryCount < retry) {
      console.log(`正在进行第 ${retryCount + 1} 次重试...`);
      setTimeout(() => {
        requestData();
        retryCount++;
      }, Math.random() * 1000 + 1000);
    }
  });

  req.on('error', (e) => {
    console.error(`请求失败: ${e.message}`);
    if (retryCount < retry) {
      console.log(`正在进行第 ${retryCount + 1} 次重试...`);
      setTimeout(() => {
        requestData();
        retryCount++;
      }, Math.random() * 1000 + 1000);
    }
  });

  req.end();
}

requestData();

在上述代码中，我们通过 requestData 函数来执行 HTTP 请求，并设置了最大重试次数为 3 次。在每次请求失败或者超时后，我们都会在控制台输出错误信息，并进行重试，直到超过最大重试次数或者重试成功为止。

需要注意的是，在每次重试时我们还会在随机范围内设置一个随机等待时间，避免触发服务器的过载保护等机制。

结语

在 Node.js 中执行 HTTP 请求是实现前后端交互的重要手段，但是在实际场景中我们也经常会遇到网络错误、超时等问题。在本文中，我们介绍了如何在 Node.js 中进行 HTTP 请求的错误处理和重试，希望对您有所帮助。无论在前端还是后端领域，了解如何正确处理错误，是每个开发者都需要具备的能力之一。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/67d7ddcba941bf7134e1221b

Node.js 中 HTTP 请求的错误处理和重试方法

HTTP 错误状态码

错误处理方法

重试方案

结语

接着读