使用net.connect时回调与Promise的差异及Promise版本报错排查

核心问题出在Node.js EventEmitter的error事件处理机制，以及Promise对这类事件错误的捕获逻辑上：

1. 回调版本正常的原因 #

你写的回调版本里，肯定给Socket实例绑定了error事件监听器，比如：

const net = require('net');

function checkPortCallback(port, callback) {
  const socket = new net.Socket();
  // 关键：显式监听error事件，处理端口不可达的错误
  socket.on('error', (err) => {
    socket.destroy();
    callback(err);
  });
  socket.connect(port, 'localhost', () => {
    socket.destroy();
    callback(null, true);
  });
}

当端口关闭/不可达时，Socket触发error事件，这个监听器会捕获错误并通过回调传递，不会让错误冒泡到全局的uncaughtException。

2. Promise版本抛错的原因 #

如果你写的Promise版本漏加了error事件监听，比如：

const net = require('net');

async function checkPortPromise(port) {
  return new Promise((resolve, reject) => {
    const socket = new net.Socket();
    // 错误：没有监听error事件
    socket.connect(port, 'localhost', () => {
      socket.destroy();
      resolve(true);
    });
  });
}

此时Socket触发error事件时，因为没有任何监听器，Node.js的EventEmitter会直接抛出未捕获的异常——这个异常不属于Promise内部同步抛出的错误，所以不会被Promise的reject自动捕获，最终触发全局的uncaughtException。

3. 正确的Promise版本写法 #

必须在Promise内部给Socket绑定error事件，把错误手动传给reject，这样错误才会进入Promise的异常链，能被try/catch或.catch()捕获：

const net = require('net');

async function checkPortPromise(port) {
  return new Promise((resolve, reject) => {
    const socket = new net.Socket();
    
    // 必须监听error事件，将错误转交给Promise的reject
    socket.on('error', (err) => {
      socket.destroy();
      reject(err);
    });
    
    socket.connect(port, 'localhost', () => {
      socket.destroy();
      resolve(true);
    });
  });
}

// 调用时用try/catch捕获错误
async function run() {
  try {
    const isOpen = await checkPortPromise(8080);
    console.log(`端口${8080}开放`);
  } catch (err) {
    console.log(`端口${8080}关闭或连接失败:`, err.message);
  }
}

run();

总结差异本质 #

• 回调和Promise场景下，EventEmitter的error事件规则是一致的：无监听则抛出全局异常。
• 差异只是你在回调版本中自然地加了error监听，而Promise版本容易忽略这一步，误以为Promise能自动捕获所有异步错误——但Node.js的事件驱动错误（比如Socket的error）不属于Promise的错误捕获范畴，必须手动关联。

内容的提问来源于stack exchange，提问作者Frenchcooc