Node CLI程序用writeFileSync重定向到管道时触发EAGAIN错误

原因分析与解答 #

1. 标准输出的缓冲模式差异 #

当输出到终端时，系统默认采用行缓冲，数据会逐行刷新，终端处理速度足够快，不会出现缓冲区满的情况。但通过管道输出给grep这类工具时，标准输出会切换为全缓冲，且管道的接收端如果处理速度慢、暂时未读取数据，就会把管道的固定大小缓冲区（比如Linux上通常为64KB）填满。

2. 同步writeFileSync的局限性 #

writeFileSync是同步阻塞API，它会尝试一次性将所有数据写入文件描述符。但管道属于特殊的文件描述符，Node.js对标准输出的处理默认开启了非阻塞模式——当管道缓冲区已满时，操作系统会返回EAGAIN，表示无法立即完成写入，而writeFileSync没有内置重试或等待逻辑，直接抛出错误。

3. 异步write API的自动重试机制 #

异步write API将写入操作交给Node.js事件循环处理，当遇到EAGAIN时，Node.js会自动监听文件描述符的可写事件，等待管道缓冲区有空位后重试写入，直到数据全部写入完成，因此不会触发错误。

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