Node.js中Promise内https.request的console.log无法实时输出如何解决？

问题场景 #

在Node.js环境中使用https.request下载数百MB文件时，data事件回调中的日志无法实时输出，直到Promise完成后才一次性打印。即使改用console.error、process.stdout.write也未解决问题。相关代码如下：

请求函数：

async function postRequest(_options, data) {
    return new Promise((resolve, reject) => {
        const req = https.request(_options, (res) => {
            let response = '';
            res.on('data', (chunk) => {
                response += chunk
                console.log(">> ", response.length) // 日志无法实时输出
            })

            res.on('end', () => {
                resolve(response);
            })
        })
        req.on('error', (err) => {
            reject(err)
        })
        req.write(data)
        req.end()
    })
}

调用方式：

const resp = await postRequest(opt, JSON.stringify(req))

原因分析 #

Node.js的标准输出（stdout）在连接到非交互式终端（如管道、文件、部分Shell环境）时，会启用块缓冲机制，只有当缓冲区填满或进程结束时才会输出内容。console.log默认依赖stdout，因此无法实时打印日志；stderr默认无缓冲，但如果被重定向，同样会出现缓冲问题。

解决方法 #

方法1：强制禁用stdout缓冲 #

在脚本开头添加以下代码，强制stdout为无阻塞（无缓冲）模式：

// 利用Node.js内部API强制实时输出，适用于大部分版本
if (process.stdout._handle) {
    process.stdout._handle.setBlocking(true);
}

之后直接使用console.log即可实时输出日志。

方法2：使用process.stdout.write并确认写入完成 #

将console.log替换为process.stdout.write，通过回调确保数据实时写入：

res.on('data', (chunk) => {
    response += chunk
    process.stdout.write(`>> ${response.length}\n`, () => {
        // 回调触发表示数据已写入终端
    });
})

方法3：外部工具禁用缓冲（输出重定向场景） #

如果需要将日志输出到文件或管道（如node script.js > output.log），可借助外部工具禁用缓冲：

# Linux/macOS 使用unbuffer
unbuffer node script.js > output.log

# Windows 使用winpty（需先安装）
winpty node script.js > output.log

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