Node.js Worker线程中process.exit致部分日志未输出问题排查

运行Worker线程时，控制台仅输出text，text2和text3未打印，推测是进程退出速度过快导致。以下是项目简化后的代码：

Worker线程代码（handler.js） #

async function func1() {
  await console.log('text2')
}

async function func() {
  await console.log('text')
  await func1();
  await console.log('text3')
}

async function handler() {
  await func()
  await process.exit(123)
}

handler();

主线程运行代码 #

const {Worker} = require('worker_threads')

const myWorker = new Worker('./handler.js')

myWorker.on('exit', (data) => {
  console.log('Worker exit: ' + data)
})

问题成因 #

console.log底层是异步写入stdout流的操作，虽然代码里加了await，但console.log本身并不返回Promise，await它只是同步执行了调用，但实际的写入操作还在队列里。当调用process.exit()时，Node.js会立即终止进程，此时队列中未完成的stdout写入（包括Worker通过IPC传递给主线程的输出）会被直接丢弃，导致text2、text3没来得及输出。

解决方法 #

方法1：等待stdout流清空后再退出

在调用process.exit前，先等待stdout的drain事件，确保所有输出都已完成写入：

async function handler() {
  await func()
  // 等待stdout流中的数据全部写入完成
  await new Promise(resolve => {
    if (!process.stdout.writableNeedDrain) {
      resolve()
    } else {
      process.stdout.once('drain', resolve)
    }
  })
  process.exit(123)
}

方法2：设置exitCode让Node自动退出

不要手动调用process.exit，而是设置process.exitCode，Node.js会在事件循环清空后自动退出，这样能保证所有异步操作（包括stdout写入）都完成：

async function handler() {
  await func()
  process.exitCode = 123
  // 无需手动调用process.exit，Node会在事件循环空闲时自动退出
}

方法3：通过IPC消息让主线程打印输出（更可靠）

让Worker把要输出的内容通过process.send发给主线程，由主线程负责打印，这样即使Worker退出，主线程也能收到所有消息：
// Worker线程修改后代码：

async function func1() {
  process.send('text2')
}

async function func() {
  process.send('text')
  await func1();
  process.send('text3')
}

async function handler() {
  await func()
  process.exit(123)
}

handler();

// 主线程修改后代码：

const {Worker} = require('worker_threads')

const myWorker = new Worker('./handler.js')

myWorker.on('message', (msg) => {
  console.log(msg)
})

myWorker.on('exit', (data) => {
  console.log('Worker exit: ' + data)
})

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