Node.js v12.16.2 的文档中，“Errors“（错误）部分主要介绍了在 Node.js 运行过程中可能会遇到的错误类型及其处理方法

已于 2025-04-03 17:38:48 修改
阅读量3.8k 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： NodeJs(Google V8 JavaScript) Javascript(Promise/asyncAwait) Npm(Node Package Manager) 文章标签： java
于 2020-04-16 19:39:45 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/blog_programb/article/details/105545662

关于 Node.js v12.16.2 的错误类型及处理方法

在 Node.js v12.16.2 中，错误通常通过 Error 对象表示，并且可以通过多种方式捕获和处理这些错误。以下是有关错误类型的分类以及常见的处理方法。

错误类型

Node.js 中的错误主要分为两类：同步错误和异步错误。

  1. 同步错误
    同步错误是指发生在主线程上的错误，通常是由于调用某些函数时传入了不合法参数引起的。这类错误可以直接通过 try...catch 块捕捉。

    try {
     
     
    const result = JSON.parse('{ invalid json }'); // 抛出 SyntaxError
} catch (err) {
     
     
    console.error(err.message); // 输出错误消息
}

  2. 异步错误
    异步错误通常由事件循环中的回调函数抛出。对于这种错误，无法直接使用 try...catch 捕捉，而是需要依赖其他机制，比如 .on('error', callback) 或者 Promise 的 .catch() 方法。

处理方法

为了更好地管理程序中的错误，Node.js 提供了几种常用的错误处理模式：

  1. 事件监听器
    可以通过绑定 'error' 事件来监听并处理错误。如果未处理该事件，则会触发默认行为（即终止进程）。例如，在流操作中可以这样设置：

    const fs = require('fs');
const readableStream = fs.createReadStream('nonexistentfile.txt');

readableStream.on('error', (err) => {
     
     
    console.error(`File read error: ${
       
       err.message}`); // 自定义错误处理逻辑
});

  2. Promise 和 Async/Await
    使用基于 Promise 的 API 能够更方便地控制异常传播路径。当发生拒绝状态时，可通过 .catch() 来获取被拒原因；或者利用 async/await 结构化语法简化代码结构。

    function delay(ms) {
     
     
    return new Promise((resolve, reject) => {
     
     
        setTimeout(() => resolve('done'), ms);
    }).then(value => {
     
      throw new Error('Something went wrong!') }); // 故意制造失败情况
}

(async () => {
     
     
    try {
     
     
        await delay(1000);
    } catch (e) {
     
     
        console.log(e.message); // Something went wrong!
    }
})();

  3. Domain 模块（已废弃）
    Domain 曾经是一个用来集中管理和统一响应多个资源间可能产生的各种问题的方法集合体，但由于其实现复杂度较高且容易引发难以调试的情况，官方已经将其标记为 deprecated 并推荐改用 clusters 或 worker_threads 等替代方案。

  4. Uncaught Exception 和 Unhandled Rejection
    当没有任何地方捕获到某个特定的错误实例时，默认情况下整个应用程序将会崩溃退出。为了避免这种情况的发生，开发者可以选择注册全局级别的处理器来进行兜底保护措施。

    process.on('uncaughtException', err => {
     
     
    console.error('There was an uncaught error:', err.stack);
    process.exit(1); // 推荐显式结束应用以防数据损坏等问题
});

process.on('unhandledRejection', reason => {
     
     
    console.warn('Unhandled rejection at promise:', reason);
});
总结

上述介绍了几种常见场景下的错误类别划分依据及其对应的解决方案思路。合理运用它们可以帮助构建更加健壮可靠的系统架构设计。

Node.js v12.16.2 的文档中，“Errors”（错误）部分主要介绍了在 Node.js 运行过程中可能会遇到的错误类型及其处理方法。以下是一些常见的错误类型和处理建议：

常见错误类型

  1. SyntaxError: 语法错误，通常是由于代码中存在不符合 JavaScript 语法规则的部分引起的。例如，缺少括号、分号等。

    // 示例：缺少分号
let a = 5
console.log(a)

  2. TypeError: 类型错误，通常是由于对不适当的数据类型进行操作引起的。例如，尝试调用一个非函数类型的变量。

    // 示例：尝试调用一个非函数类型的变量
let obj = {
     
     };
obj(); // TypeError: obj is not a function

  3. ReferenceError: 引用错误，通常是由于访问未定义的变量或对象属性引起的。

    // 示例：访问未定义的变量
console.log(nonExistentVariable); // ReferenceError: nonExistentVariable is not defined

  4. RangeError: 范围错误，通常是由于数值超出允许的范围引起的。例如，数组长度超过最大值。

    // 示例：数组长度超过最大值
let arr = new Array(Number.MAX_SAFE_INTEGER + 1); // RangeError: Invalid array length

  5. EvalError: 评估错误，通常与 eval() 函数的使用有关，但现代 JavaScript 中已不再使用 eval()，因此很少见。

错误处理建议

  1. 调试工具: 使用调试工具如 Chrome DevTools、VSCode Debugger 等来定位和修复错误。
  2. 日志记录: 使用 console.log()、console.error() 等方法记录错误信息，帮助追踪问题。
  3. 异常捕获: 使用 try...catch 语句捕获并处理异常，防止程序崩溃。
    try {
     
     
    // 可能抛出错误的代码
    let result = someFunction();
} catch (error) {
     
     
    console.error('An error occurred:', error);
}
  4. 单元测试: 编写单元测试来验证代码的正确性，提前发现和修复错误。
  5. 代码审查: 通过代码审查和同行评审来发现潜在的错误和改进点。

Index View on single page View as JSON View another version ▼ 

Edit on GitHub

Table of Contents

Errors

    Error Propagation and Interception
        Error-first callbacks

    Class: Error
        new Error(message)
        Error.captureStackTrace(targetObject[, constructorOpt])
        Error.stackTraceLimit
        error.code
        error.message
        error.stack
    Class: AssertionError
    Class: RangeError
    Class: ReferenceError
    Class: SyntaxError

    Class: SystemError
        error.address
        error.code
        error.dest
        error.errno
        error.info
        error.message
        error.path
        error.port
        error.syscall
        Common System Errors
    Class: TypeError
    Exceptions vs. Errors

    OpenSSL Errors
        error.opensslErrorStack
        error.function
        error.library
        error.reason

    Node.js Error Codes
        ERR_AMBIGUOUS_ARGUMENT
        ERR_ARG_NOT_ITERABLE
        ERR_ASSERTION
        ERR_ASYNC_CALLBACK
        ERR_ASYNC_TYPE
        ERR_BROTLI_COMPRESSION_FAILED
        ERR_BROTLI_INVALID_PARAM
        ERR_BUFFER_CONTEXT_NOT_AVAILABLE
        ERR_BUFFER_OUT_OF_BOUNDS
        ERR_BUFFER_TOO_LARGE
        ERR_CANNOT_WATCH_SIGINT
        ERR_CHILD_CLOSED_BEFORE_REPLY
        ERR_CHILD_PROCESS_IPC_REQUIRED
        ERR_CHILD_PROCESS_STDIO_MAXBUFFER
        ERR_CONSOLE_WRITABLE_STREAM
        ERR_CONSTRUCT_CALL_REQUIRED
        ERR_CONSTRUCT_CALL_INVALID
        ERR_CPU_USAGE
        ERR_CRYPTO_CUSTOM_ENGINE_NOT_SUPPORTED
        ERR_CRYPTO_ECDH_INVALID_FORMAT
        ERR_CRYPTO_ECDH_INVALID_PUBLIC_KEY
        ERR_CRYPTO_ENGINE_UNKNOWN
        ERR_CRYPTO_FIPS_FORCED
        ERR_CRYPTO_FIPS_UNAVAILABLE
        ERR_CRYPTO_HASH_FINALIZED
        ERR_CRYPTO_HASH_UPDATE_FAILED
        ERR_CRYPTO_INCOMPATIBLE_KEY_OPTIONS
        ERR_CRYPTO_INVALID_DIGEST
        ERR_CRYPTO_INVALID_KEY_OBJECT_TYPE
        ERR_CRYPTO_INVALID_STATE
        ERR_CRYPTO_PBKDF2_ERROR
        ERR_CRYPTO_SCRYPT_INVALID_PARAMETER
        ERR_CRYPTO_SCRYPT_NOT_SUPPORTED
        ERR_CRYPTO_SIGN_KEY_REQUIRED
        ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH
        ERR_DIR_CLOSED
        ERR_DNS_SET_SERVERS_FAILED
        ERR_DOMAIN_CALLBACK_NOT_AVAILABLE
        ERR_DOMAIN_CANNOT_SET_UNCAUGHT_EXCEPTION_CAPTURE
        ERR_ENCODING_INVALID_ENCODED_DATA
        ERR_ENCODING_NOT_SUPPORTED
        ERR_FALSY_VALUE_REJECTION
        ERR_FS_FILE_TOO_LARGE
        ERR_FS_INVALID_SYMLINK_TYPE
        ERR_HTTP_HEADERS_SENT
        ERR_HTTP_INVALID_HEADER_VALUE
        ERR_HTTP_INVALID_STATUS_CODE
        ERR_HTTP_TRAILER_INVALID
        ERR_HTTP2_ALTSVC_INVALID_ORIGIN
        ERR_HTTP2_ALTSVC_LENGTH
        ERR_HTTP2_CONNECT_AUTHORITY
        ERR_HTTP2_CONNECT_PATH
        ERR_HTTP2_CONNECT_SCHEME
        ERR_HTTP2_ERROR
        ERR_HTTP2_GOAWAY_SESSION
        ERR_HTTP2_HEADERS_AFTER_RESPOND
        ERR_HTTP2_HEADERS_SENT
        ERR_HTTP2_HEADER_SINGLE_VALUE
        ERR_HTTP2_INFO_STATUS_NOT_ALLOWED
        ERR_HTTP2_INVALID_CONNECTION_HEADERS
        ERR_HTTP2_INVALID_HEADER_VALUE
        ERR_HTTP2_INVALID_INFO_STATUS
        ERR_HTTP2_INVALID_ORIGIN
        ERR_HTTP2_INVALID_PACKED_SETTINGS_LENGTH
        ERR_HTTP2_INVALID_PSEUDOHEADER
        ERR_HTTP2_INVALID_SESSION
        ERR_HTTP2_INVALID_SETTING_VALUE
        ERR_HTTP2_INVALID_STREAM
        ERR_HTTP2_MAX_PENDING_SETTINGS_ACK
        ERR_HTTP2_NESTED_PUSH
        ERR_HTTP2_NO_SOCKET_MANIPULATION
        ERR_HTTP2_ORIGIN_LENGTH
        ERR_HTTP2_OUT_OF_STREAMS
        ERR_HTTP2_PAYLOAD_FORBIDDEN
        ERR_HTTP2_PING_CANCEL
        ERR_HTTP2_PING_LENGTH
        ERR_HTTP2_PSEUDOHEADER_NOT_ALLOWED
        ERR_HTTP2_PUSH_DISABLED
        ERR_HTTP2_SEND_FILE
        ERR_HTTP2_SEND_FILE_NOSEEK
        ERR_HTTP2_SESSION_ERROR
        ERR_HTTP2_SETTINGS_CANCEL
        ERR_HTTP2_SOCKET_BOUND
        ERR_HTTP2_SOCKET_UNBOUND
        ERR_HTTP2_STATUS_101
        ERR_HTTP2_STATUS_INVALID
        ERR_HTTP2_STREAM_CANCEL
        ERR_HTTP2_STREAM_ERROR
        ERR_HTTP2_STREAM_SELF_DEPENDENCY
        ERR_HTTP2_TRAILERS_ALREADY_SENT
        ERR_HTTP2_TRAILERS_NOT_READY
        ERR_HTTP2_UNSUPPORTED_PROTOCOL
        ERR_INTERNAL_ASSERTION
        ERR_INCOMPATIBLE_OPTION_PAIR
        ERR_INPUT_TYPE_NOT_ALLOWED
        ERR_INSPECTOR_ALREADY_CONNECTED
        ERR_INSPECTOR_CLOSED
        ERR_INSPECTOR_COMMAND
        ERR_INSPECTOR_NOT_ACTIVE
        ERR_INSPECTOR_NOT_AVAILABLE
        ERR_INSPECTOR_NOT_CONNECTED
        ERR_INSPECTOR_NOT_WORKER
        ERR_INVALID_ADDRESS_FAMILY
        ERR_INVALID_ARG_TYPE
        ERR_INVALID_ARG_VALUE
        ERR_INVALID_ASYNC_ID
        ERR_INVALID_BUFFER_SIZE
        ERR_INVALID_CALLBACK
        ERR_INVALID_CHAR
        ERR_INVALID_CURSOR_POS
        ERR_INVALID_FD
        ERR_INVALID_FD_TYPE
        ERR_INVALID_FILE_URL_HOST
        ERR_INVALID_FILE_URL_PATH
        ERR_INVALID_HANDLE_TYPE
        ERR_INVALID_HTTP_TOKEN
        ERR_INVALID_IP_ADDRESS
        ERR_INVALID_MODULE_SPECIFIER
        ERR_INVALID_OPT_VALUE
        ERR_INVALID_OPT_VALUE_ENCODING
        ERR_INVALID_PACKAGE_CONFIG
        ERR_INVALID_PACKAGE_TARGET
        ERR_INVALID_PERFORMANCE_MARK
        ERR_INVALID_PROTOCOL
        ERR_INVALID_REPL_EVAL_CONFIG
        ERR_INVALID_REPL_INPUT
        ERR_INVALID_RETURN_PROPERTY
        ERR_INVALID_RETURN_PROPERTY_VALUE
        ERR_INVALID_RETURN_VALUE
        ERR_INVALID_SYNC_FORK_INPUT
        ERR_INVALID_THIS
        ERR_INVALID_TRANSFER_OBJECT
        ERR_INVALID_TUPLE
        ERR_INVALID_URI
        ERR_INVALID_URL
        ERR_INVALID_URL_SCHEME
        ERR_IPC_CHANNEL_CLOSED
        ERR_IPC_DISCONNECTED
        ERR_IPC_ONE_PIPE
        ERR_IPC_SYNC_FORK
        ERR_MANIFEST_ASSERT_INTEGRITY
        ERR_MANIFEST_DEPENDENCY_MISSING
        ERR_MANIFEST_INTEGRITY_MISMATCH
        ERR_MANIFEST_INVALID_RESOURCE_FIELD
        ERR_MANIFEST_PARSE_POLICY
        ERR_MANIFEST_TDZ
        ERR_MANIFEST_UNKNOWN_ONERROR
        ERR_MEMORY_ALLOCATION_FAILED
        ERR_METHOD_NOT_IMPLEMENTED
最低0.47元/天 解锁文章

200万优质内容无限畅学
用selenium爬取网页时出现报错：ERR_HTTP2_PROTOCOL_ERROR...如何解决？
**My Coding Family**
07-07 1085
🏆本文收录于 《全栈Bug调优(实战版)》 专栏，该专栏专注于分享我在真实项目开发中遇到的各类疑难Bug及其深层成因，并系统提供高效、可复现的解决思路和实操方案。无论你是刚入行的新手开发者，还是拥有多年项目经验的资深工程师，本专栏都将为你提供一条系统化、高质量的问题排查与优化路径，助力你加速成长，攻克技术壁垒，迈向技术价值最大化与职业发展的更高峰🚀！
在Node.js v12.16.2中，IPC支持主要通过`child_process`模块实现，以下是核心要点
BLOG域名:programb.blog.csdn.net
04-16 413
无论您是刚开始接触Node.js的新手，还是已经有一定经验的开发者，都可以从这份文档中获得有价值的信息和指导。文档的最后一部分提供了如何测试和调试IPC代码的指南。测试和调试章节详细介绍了如何使用Node.js提供的工具和技术来测试IPC代码，以及如何定位和解决可能出现的错误。例如，当需要在子进程中使用第三方模块或执行需要特定环境的操作时，IPC的使用可能会有一些额外的复杂性。无论您是开发人员、测试人员还是系统管理员，这份文档都是一个宝贵的资源，可以帮助您更好地利用IPC功能，提高应用程序的稳定性和性能。
PyNio读取数据出现file format not supported or file is corrupted
xiaoxiami233的博客
04-19 6839
ncl 转到python平台已经有一段时间了，从安装到读文件，真的是步步艰辛哪！摸索许久，也终于有了点心得，以前在这个平台得到许多帮助，现在作为第一批吃螃蟹的人（不是第一批也算比较早吧！），我也来贡献一下自己小小的力量吧！ 1、就目前来说，PyNIOn ，PyNGL这两个包只能安装在linux系统下，与python能不能安装在windows下无关，即使是VS下的powershell即使有着类...
pnpm (ERR_INVALID_THIS)异常在Node.js v20
秋雨夕照的博客
11-05 4740
从Node.js v18 升级到 v20 后，遇到错误。
action-setup出现pnpm (ERR_INVALID_THIS)异常在pnpm v8和node.js v20
花木凋零成兰的博客
07-04 946
pnpm/action-setup 自行安装程序问题。
pnpm 使用 workspace 报错 ERR_INVALID_THIS
阿臻
04-15 1654
原因就是 pnpm 的 bug！把你的pnpm升级到。有时候真的感觉如果有一个老师指路，那么走的坑真的会少很多。
@HTTP状态码
weixin_49329785的博客
07-22 292
HTTP 状态码的作用是服务器告诉客户端当前请求响应的状态，通过状态码就能判断和分析服务器的运行状态；状态码的第一位数字表示状态类型，第二、三位数字表示具体的情况
Node.js v12.16.2 文档中关于HTTP的部分主要介绍了如何使用Node.js的内置HTTP模块来创建服务器和客户端
BLOG域名:programb.blog.csdn.net
04-16 457
如果你需要更深入的了解或者有特定的问题，我建议你查阅Node.js的官方文档，或者找一些关于Node.js和HTTP模块的在线教程。总的来说，Node.js的HTTP模块提供了丰富的功能和强大的灵活性，可以帮助开发者构建各种规模的Web应用程序和服务。HTTP/2是一个更现代、更高效的协议，与HTTP/1.1相比，它提供了更好的性能和安全性。Node.js v12.16.2 文档中关于HTTP的部分主要介绍了如何使用Node.js的内置HTTP模块来创建服务器和客户端，以及如何处理HTTP请求和响应。
Node.js v12.16.2 Documentation Errors
12-17
Node.js v12.16.2 的文档中，"Errors"（错误）部分主要介绍了在 Node.js 运行过程中可能会遇到的错误类型及其处理方法。以下是一些常见的错误类型和处理建议： ### 常见错误类型 1. **SyntaxError**: 语法错误，...
在Node.js v12.16.2中，Domain模块已被标记为**弃用(deprecated)**，但仍保留在文档中以兼容旧代码
BLOG域名:programb.blog.csdn.net
04-16 344
优先使用async/await：使异步代码具备同步错误捕获能力避免忽略Promise拒绝：所有.then()后必须跟.catch()框架级错误聚合：如Express的集中式错误中间件全局兜底仅用于日志中不可继续运行业务逻辑错误边界划分：模块间通过throw或reject传播错误，由调用方处理。
使用ubuntu遇到的问题-An error occurred,please run Package Manager...
idealcitier's Daily life
10-20 9229
最近在使用Ubuntu的过程中遇到提示一些错误。 提示： An error occurred,please run Package Manager from the right-click menu or apt-get in a terminal to see what is wrong.The error message was: 'Error:BrokenCount>0'This us
【报错记录】pnpm install报WARN GET xxx error (ERR_INVALID_THIS). Will retry in 10 seconds. 2 retries left.
最新发布
DCTANT的博客
02-21 2294
项目背景是这样的，我换了台新电脑，node、pnpm全部都是新装的，vue-element-plus-admin项目使用pnpm执行pnpm install报错了，内容为：WARN GET xxx error (ERR_INVALID_THIS). Will retry in 10 seconds. 2 retries left.。这篇文字就教大家解决这个问题
“Error: Ensure the container of the graph is specified and valid“：antv-x6报错
weixin_44213308的博客
12-16 6186
antv-X6快速上手报错： 发现原因是因为： 正确的代码如下： <template> <div id="container"> </div> </template> <script> import { Graph } from '@antv/x6'; const data = { // 节点 nodes: [ { id: 'node1', // String，可选，节点的唯一标识
优先级队列 二叉堆
我是要成为海贼王的男人！
08-23 261
package huawei; public class test7 { public static void main(String[] args) { // TODO Auto-generated method stub MaxPQ<Character> youxianjiMaxPQ = new MaxPQ<Character>(5); youxian...
node报错npm ERR! code ERR_TLS_CERT_ALTNAME_INVALID npm ERR! npm ERR! request to https://registry.cnpmj
weixin_42893818的博客
06-19 1293
npm ERR! code ERR_TLS_CERT_ALTNAME_INVALID npm ERR! errno ERR_TLS_CERT_ALTNAME_INVALID npm ERR! request to https://registry.cnpmjs.org/vue-cli failed, reason: Hostname/IP does not match certificate's altnames: Host: registry.cnpmjs.org. is not in the cert'
Postman安装newman时报错npm ERR! code ERR_TLS_CERT_ALTNAME_INVALID
xiaobawangle的博客
08-08 611
win+R 输入cmd 在控制台中依次输入。等待安装完成输入newman -v。
npm install 出现 code ERR_TLS_CERT_ALTNAME_INVALID 的错误
qhexin的专栏
07-28 2351
解决方式 npm config set strict-ssl false
vue3打包 error in node_modules/@types/node/stream/web.d.ts 错误解决办法
weixin_46432232的博客
09-13 1869
这里说@types/node这个插件报错，点进去发现这行代码。这里是一个typescript的类型继承定义，直接改这样。ue3项目打包的时候突然报错，错误如下。
npm ERR! code ERR_TLS_CERT_ALTNAME_INVALID解决办法
饭饭
06-20 4259
错误： npm install --save @riophae/vue-treeselect npm ERR! code ERR_TLS_CERT_ALTNAME_INVALID npm ERR! errno ERR_TLS_CERT_ALTNAME_INVALID npm ERR! request to https://registry.cnpmjs.org/@riophae%2fvue-treeselect failed, reason: Hostname/IP does not match cert
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Bol5261

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值