Node.js+TypeScript环境下动态import加await致程序无报错退出问题

解决方案 #

你使用的Node v16.2.0属于早期Node 16版本，存在ESM动态import搭配await的已知崩溃BUG，优先升级到Node 16最新LTS（v16.20.2）或更高LTS版本（18/20），绝大多数场景下该问题可直接修复。

如果暂时无法升级Node版本，可采用以下兼容方案：

• 用Promise.all批量加载替代循环内逐次await，规避Node底层触发崩溃的执行逻辑，同时可以保证所有命令加载完成后loadCommands才会返回，示例代码如下：

export async function loadCommands(): Promise<void> {
    const commandFiles = await loadCommandFiles();
    await Promise.all(
        commandFiles.map(async (file) => {
            const { command } = await import(`#commands/${file}`);
            console.log(command);
            // 此处补充你的命令注册逻辑
        })
    );
}

• 添加强制错误捕获逻辑，排查隐藏的静默异常：
  在项目入口文件最顶部添加全局未捕获Promise rejection监听，避免异常静默触发进程退出：

process.on('unhandledRejection', (err) => {
    console.error('未捕获的异步错误：', err);
});

同时可以给动态import逻辑添加局部try/catch确认错误细节：

for (const file of commandFiles) {
    try {
        const { command } = await import(`#commands/${file}`);
        console.log(command);
    } catch (err) {
        console.error(`加载命令${file}失败：`, err);
    }
}

• 校验TS配置正确性：
  确认你的tsconfig.json中moduleResolution配置为NodeNext，保证转译后的ESM模块逻辑符合Node规范，避免转译产物异常导致的进程崩溃。

之前链式调用Promise不崩溃的原因是，未被await的异步任务属于游离的后台任务，Node不会将其异常关联到主调用链，也不会等待任务执行完成，因此不会触发对应BUG，但会出现命令加载未完成就执行后续逻辑的问题。

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