Node.js+TypeScript：处理永不resolve/reject的Promise（禁用超时）

问题场景 #

以下TypeScript代码在Node.js环境运行时，仅输出in promise后进程就以0状态码静默退出，console.log('done')始终不会执行——原因是传入的Promise既没有resolve也没有reject，处于永久挂起状态：

async function runPromise(promise: Promise<unknown>) {
    await promise
    console.log('done')
}

void runPromise(new Promise(() => {
    console.log('in promise')
}))

需要优化runPromise函数，让这类传入永不决议Promise的场景主动抛出错误而非静默退出，且不能使用超时方案（无法预估合理的等待时长）。

同时有疑问：为什么Node.js遇到未完成的Promise时会直接关闭进程，而非无限挂起？

解决方案：追踪未决议Promise并在退出前报错 #

不需要依赖超时，我们可以利用Node.js的beforeExit事件，结合集合追踪所有进入runPromise的Promise，在进程准备退出时检查是否有未决议的Promise残留：

const pendingPromises = new Set<Promise<unknown>>();

// 监听进程退出前的钩子
process.on('beforeExit', () => {
    if (pendingPromises.size > 0) {
        const err = new Error(`发现${pendingPromises.size}个从未决议的Promise`);
        console.error(err);
        process.exitCode = 1; // 设置非0退出码，标记进程异常退出
    }
});

async function runPromise(promise: Promise<unknown>) {
    pendingPromises.add(promise);
    try {
        await promise;
        console.log('done');
    } finally {
        // 无论Promise成功还是失败，都从追踪集合中移除
        pendingPromises.delete(promise);
    }
}

// 测试：传入永不决议的Promise
void runPromise(new Promise(() => {
    console.log('in promise')
}));

逻辑说明 #

• 用Set维护所有正在等待决议的Promise，进入runPromise时添加，决议完成（无论resolve/reject）时在finally中移除
• 当Node.js准备退出时触发beforeExit事件，若集合非空，说明存在未决议的Promise，此时抛出错误并设置非0退出码，避免静默退出
• 正常决议的Promise会被及时从集合中移除，不影响进程正常退出

关于Node.js进程退出的疑问解答 #

Node.js的事件循环退出逻辑是：只要事件循环队列中没有待执行的异步任务，进程就会退出。

未决议的Promise本身只是内存中的一个对象，并没有向事件循环队列中添加任何待执行的回调（resolve或reject的逻辑从未被触发），所以Node.js会认为没有需要继续处理的任务，直接终止进程。

所谓的停机问题是指无法通过算法判断任意程序是否会终止，但Node.js的退出逻辑不涉及判断Promise是否会决议——它只看事件循环队列是否为空，因此不会因为存在未决议的Promise就保持进程挂起。

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