nodejs的错误处理过程记录

本文以连接错误ECONNREFUSED为例，看看nodejs对错误处理的过程。 假设我们有以下代码

1.  const net = require('net');
2.  net.connect({port: 9999})

如果本机上没有监听9999端口，那么我们会得到以下输出。

1.  events.js:170
2.        throw er; // Unhandled 'error' event
3.        ^
4.
5.  Error: connect ECONNREFUSED 127.0.0.1:9999
6.      at TCPConnectWrap.afterConnect [as oncomplete] (net.js:1088:14)
7.  Emitted 'error' event at:
8.      at emitErrorNT (internal/streams/destroy.js:91:8)
9.      at emitErrorAndCloseNT (internal/streams/destroy.js:59:3)
10.     at processTicksAndRejections (internal/process/task_queues.js:81:17)

我们简单看一下connect的调用流程。

1.  const req = new TCPConnectWrap();
2.  req.oncomplete = afterConnect;
3.  req.address = address;
4.  req.port = port;
5.  req.localAddress = localAddress;
6.  req.localPort = localPort;
7.  // 开始三次握手建立连接
8.  err = self._handle.connect(req, address, port);

接着我们看一下C++层connect的逻辑

1.  err = req_wrap->Dispatch(uv_tcp_connect,
2.                               &wrap->handle_,
3.                               reinterpret_cast<const sockaddr*>(&addr),
4.                               AfterConnect);

C++层直接调用Libuv的uv_tcp_connect，并且设置回调是AfterConnect。接着我们看libuv的实现。

1.  do {
2.      errno = 0;
3.      // 非阻塞调用
4.      r = connect(uv__stream_fd(handle), addr, addrlen);
5.    } while (r == -1 && errno == EINTR);
6.    // 连接错误，判断错误码
7.    if (r == -1 && errno != 0) {
8.      // 还在连接中，不是错误，等待连接完成，事件变成可读
9.      if (errno == EINPROGRESS)
10.       ; /* not an error */
11.     else if (errno == ECONNREFUSED)
12.       // 连接被拒绝
13.       handle->delayed_error = UV__ERR(ECONNREFUSED);
14.     else
15.       return UV__ERR(errno);
16.   }
17.   uv__req_init(handle->loop, req, UV_CONNECT);
18.   req->cb = cb;
19.   req->handle = (uv_stream_t*) handle;
20.   QUEUE_INIT(&req->queue);
21.   // 挂载到handle，等待可写事件
22.   handle->connect_req = req;
23.   uv__io_start(handle->loop, &handle->io_watcher, POLLOUT);

我们看到Libuv以异步的方式调用操作系统，然后把request挂载到handle中，并且注册等待可写事件，当连接失败的时候，就会执行uv stream_io回调，我们看一下Libuv的处理（uv stream_io）。

1.  getsockopt(uv__stream_fd(stream),
2.                 SOL_SOCKET,
3.                 SO_ERROR,
4.                 &error,
5.                 &errorsize);
6.  error = UV__ERR(error);
7.  if (req->cb)
8.      req->cb(req, error);

获取错误信息后回调C++层的AfterConnect。

1.  Local<Value> argv[5] = {
2.     Integer::New(env->isolate(), status),
3.     wrap->object(),
4.     req_wrap->object(),
5.     Boolean::New(env->isolate(), readable),
6.     Boolean::New(env->isolate(), writable)
7.   };
8.
9.   req_wrap->MakeCallback(env->oncomplete_string(), arraysize(argv), argv);

接着调用JS层的oncomplete回调。

1.  const ex = exceptionWithHostPort(status,
2.                                   'connect',
3.                                   req.address,
4.                                   req.port,
5.                                   details);
6.  if (details) {
7.    ex.localAddress = req.localAddress;
8.    ex.localPort = req.localPort;
9.  }
10. // 销毁socket
11. self.destroy(ex);

exceptionWithHostPort构造错误信息，然后销毁socket并且以ex为参数触发error事件。我们看看uvExceptionWithHostPort的实现。

1.  function uvExceptionWithHostPort(err, syscall, address, port) {
2.    const [ code, uvmsg ] = uvErrmapGet(err) || uvUnmappedError;
3.    const message = `${syscall} $[code]: ${uvmsg}`;
4.    let details = '';
5.
6.    if (port && port > 0) {
7.      details = ` ${address}:${port}`;
8.    } else if (address) {
9.      details = ` ${address}`;
10.   }
11.   const tmpLimit = Error.stackTraceLimit;
12.   Error.stackTraceLimit = 0;
13.   const ex = new Error(`${message}${details}`);
14.   Error.stackTraceLimit = tmpLimit;
15.   ex.code = code;
16.   ex.errno = err;
17.   ex.syscall = syscall;
18.   ex.address = address;
19.   if (port) {
20.     ex.port = port;
21.   }
22.   // 获取调用栈信息但不包括当前调用的函数uvExceptionWithHostPort，注入stack字段到ex中
23.   Error.captureStackTrace(ex, excludedStackFn || uvExceptionWithHostPort);
24.   return ex;
25. }

我们看到错误信息主要通过uvErrmapGet获取

1.  function uvErrmapGet(name) {
2.    uvBinding = lazyUv();
3.    if (!uvBinding.errmap) {
4.      uvBinding.errmap = uvBinding.getErrorMap();
5.    }
6.    return uvBinding.errmap.get(name);
7.  }
8.
9.  function lazyUv() {
10.   if (!uvBinding) {
11.     uvBinding = internalBinding('uv');
12.   }
13.   return uvBinding;
14. }

继续往下看，uvErrmapGet调用了C++层的uv模块的getErrorMap。

1.  void GetErrMap(const FunctionCallbackInfo<Value>& args) {
2.    Environment* env = Environment::GetCurrent(args);
3.    Isolate* isolate = env->isolate();
4.    Local<Context> context = env->context();
5.
6.    Local<Map> err_map = Map::New(isolate);
7.    // 从per_process::uv_errors_map中获取错误信息
8.    size_t errors_len = arraysize(per_process::uv_errors_map);
9.    // 赋值
10.   for (size_t i = 0; i < errors_len; ++i) {
11.      // map的键是 uv_errors_map每个元素中的value，值是name和message
12.     const auto& error = per_process::uv_errors_map[i];
13.     Local<Value> arr[] = {OneByteString(isolate, error.name),
14.                           OneByteString(isolate, error.message)};
15.     if (err_map
16.             ->Set(context,
17.                   Integer::New(isolate, error.value),
18.                   Array::New(isolate, arr, arraysize(arr)))
19.             .IsEmpty()) {
20.       return;
21.     }
22.   }
23.
24.   args.GetReturnValue().Set(err_map);
25. }

我们看到错误信息存在per_process::uv_errors_map中，我们看一下uv_errors_map的定义。

1.  struct UVError {
2.    int value;
3.    const char* name;
4.    const char* message;
5.  };
6.
7.  static const struct UVError uv_errors_map[] = {
8.  #define V(name, message) {UV_##name, #name, message},
9.      UV_ERRNO_MAP(V)
10. #undef V
11. };

UV_ERRNO_MAP宏展开后如下

1.  {UV_E2BIG, "E2BIG", "argument list too long"},
2.  {UV_EACCES, "EACCES", "permission denied"},
3.  {UV_EADDRINUSE, "EADDRINUSE", "address already in use"},
4.  ……

所以导出到JS层的结果如下

1.  {
2.    // 键是一个数字，由Libuv定义，其实是封装了操作系统的定义
3.    UV_ECONNREFUSED: ["ECONNREFUSED", "connection refused"],
4.    UV_ECONNRESET: ["ECONNRESET", "connection reset by peer"]
5.    ...
6.  }

Node.js最后会组装这些信息返回给调用方。这就是我们输出的错误信息。那么为什么会是ECONNREFUSED呢？我们看一下操作系统对于该错误码的逻辑。

1.  static void tcp_reset(struct sock *sk)
2.  {
3.      switch (sk->sk_state) {
4.          case TCP_SYN_SENT:
5.              sk->sk_err = ECONNREFUSED;
6.              break;
7.           // ...
8.      }
9.
10. }

当操作系统收到一个发给该socket的rst包的时候会执行tcp_reset，我们看到当socket处于发送syn包等待ack的时候，如果收到一个fin包，则会设置错误码为ECONNREFUSED。我们输出的正是这个错误码。

总结

到此这篇关于nodejs的错误处理过程记录的文章就介绍到这了,更多相关nodejs错误处理内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

• NodeJS处理Express中异步错误
• 如何优雅地在Node应用中进行错误异常处理
• node错误处理与日志记录的实现
• Node错误处理笔记之挖坑系列教程