在 Node.js 里读取文件时，`fs.readFile` 和 `fs.createReadStream` 是最常被拿来比较的两个 API。很多接口在本地开发时用 `readFile` 跑得好好的，一上线遇到几十 MB 的日志文件或用户上传的压缩包，进程内存就迅速上涨，甚至直接 OOM。原因并不复杂：`readFile` 会把整个文件一次性读进内存再回调给你，而 `createReadStream` 基于流和缓冲区逐块读取，天然带背压控制。但流也不是银弹，错误处理、文件描述符关闭、编码转换都有坑。这篇文章从实际代码出发，聊清楚两者在内存占用、错误传播和资源释放上的差异，以及什么时候该用哪个。

先把两个 API 的基本形态摆出来。`fs.readFile` 的签名是 `fs.readFile(path, options, callback)`，也支持 Promise 版本 `fs.promises.readFile`。它内部会先 stat 文件拿到大小，分配对应大小的 Buffer，然后循环读取直到读满。对于几 KB 的配置文件、模板文件，这种一次性读取完全没问题，代码也最短：

```js
const fs = require('fs/promises');

async function loadConfig() {
 const raw = await fs.readFile('./config.json', 'utf8');
 return JSON.parse(raw);
}
```

问题出在文件大小不可控的场景。假设有一个导出 CSV 的接口，用户可能导出几千行，也可能导出几百万行。用 `readFile` 意味着整个 CSV 会先落在内存里，再拼成响应。并发几个请求，内存曲线就会非常难看。换成流式读取，数据可以边读边写：

```js
const fs = require('fs');
const { pipeline } = require('stream/promises');

async function exportCsv(res) {
 const source = fs.createReadStream('./data.csv');
 res.setHeader('Content-Type', 'text/csv');
 await pipeline(source, res);
}
```

`pipeline` 的好处是它会把源流的错误、目标流的错误以及销毁逻辑都串起来。以前用 `source.pipe(res)` 时，如果 `res` 提前关闭（比如客户端断开），源流不一定会被销毁，文件描述符可能一直挂着。`pipeline` 在任一环节出错或结束时都会清理上游资源，这在长时间运行的服务里很重要。

流式读取还有一个容易被忽略的点：`createReadStream` 默认的 `highWaterMark` 是 64KB，也就是每次从文件读 64KB 到内部缓冲区。这个值不是越大越好，也不是越小越好。处理文本行时，如果单行长度可能超过 64KB，按 chunk 切分就会把一行截断。常见做法是用 `readline` 模块包一层：

```js
const fs = require('fs');
const readline = require('readline');

async function processLargeLog(filePath) {
 const stream = fs.createReadStream(filePath, { encoding: 'utf8' });
 const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });

 for await (const line of rl) {
 if (line.includes('ERROR')) {
 // 处理错误行
 }
 }
}
```

这里 `crlfDelay: Infinity` 是为了兼容 Windows 换行，避免 `\r\n` 被拆成两次事件。用 `for await` 消费 `readline` 接口时，背压是自动处理的：当循环体处理慢时，`readline` 会暂停输入流，等消费端准备好再继续。

错误处理是另一个分水岭。`readFile` 的错误集中在一次回调里，文件不存在、权限不足、读取中途磁盘出错，都会走同一个 `error` 参数。流的错误则可能发生在不同阶段：打开文件失败会触发 `error`，读取过程中出错也会触发 `error`，但如果你只监听了 `data` 而没监听 `error`，进程可能直接崩溃。用 `pipeline` 或 `events.once` 能减少这种遗漏：

```js
const { once } = require('events');

async function readFirstChunk(filePath) {
 const stream = fs.createReadStream(filePath, { highWaterMark: 16 });
 try {
 const [chunk] = await once(stream, 'data');
 console.log('first bytes:', chunk.toString());
 stream.destroy();
 } catch (err) {
 console.error('read failed:', err.message);
 }
}
```

注意 `stream.destroy()` 那一步。只读一小段就结束的场景下，不销毁流会留下打开的文件描述符，虽然 Node 有 GC 兜底，但依赖 GC 释放系统资源不是好习惯。

那是不是所有场景都该用流？也不是。流引入了更多状态和事件，代码复杂度上升。读取一个 2KB 的 HTML 模板、一个小的 JSON 配置、一次性的证书文件，`readFile` 更直接，也更容易做缓存。判断标准可以落到文件大小和生命周期上：文件大小有上限且较小，读完即用，选 `readFile`；文件大小不可控、需要边读边处理、或者要转发给另一个流，选 `createReadStream`。另外，`readFile` 对小于 `highWaterMark` 的文件其实也只读一次，性能并不差，不要为了“看起来高级”强行上流。

还有一个实际开发中常踩的坑：`createReadStream` 的 `encoding` 选项。设置 `encoding: 'utf8'` 后，chunk 是字符串，但多字节字符可能被切在两个 chunk 之间，导致乱码。Node 的 StringDecoder 在流内部会处理大部分情况，但如果你手动对 Buffer 做 `toString()` 再拼接，就要自己处理边界。处理二进制文件时更不要随便设 encoding，保持 Buffer 原样传给下游。

文件描述符泄漏在容器环境里尤其致命。默认 `ulimit -n` 可能是 1024，一个泄漏的流在压测下很快就能把描述符耗尽，表现为 `EMFILE: too many open files`。排查这类问题时，可以临时打印 `process._getActiveHandles()` 看还有哪些流没关，或者用 `lsof -p <pid>` 观察打开的文件。预防手段就是统一用 `pipeline` 或 `stream.finished` 管理生命周期，避免裸 `pipe` 加手动 `close`。

最后给一个混合场景收尾：读取上传的图片并生成缩略图。原图可能很大，不适合 `readFile`，但图像处理库往往需要完整 Buffer。这时可以流式读入并通过 `sharp` 这类库的流接口处理，或者先落盘再处理，而不是把整个文件塞进内存。选 API 之前先问自己：这个文件最大能有多大，我能不能分块处理，出错时资源谁来关。答案清楚了，`readFile` 和 `createReadStream` 就不会选错。

 推荐查看笑话：https://www.tianqi323.com/joke/7238.html
 推荐查看笑话：https://www.tianqi323.com/joke/7239.html
 推荐查看笑话：https://www.tianqi323.com/joke/7240.html
 推荐查看笑话：https://www.tianqi323.com/joke/7241.html
 推荐查看笑话：https://www.tianqi323.com/joke/7242.html
 推荐查看笑话：https://www.tianqi323.com/joke/7243.html
 推荐查看笑话：https://www.tianqi323.com/joke/7244.html
 推荐查看笑话：https://www.tianqi323.com/joke/7245.html
 推荐查看笑话：https://www.tianqi323.com/joke/7246.html
 推荐查看笑话：https://www.tianqi323.com/joke/7247.html
 推荐查看笑话：https://www.tianqi323.com/joke/7248.html
 推荐查看笑话：https://www.tianqi323.com/joke/7249.html
 推荐查看笑话：https://www.tianqi323.com/joke/7250.html
 推荐查看笑话：https://www.tianqi323.com/joke/7251.html
 推荐查看笑话：https://www.tianqi323.com/joke/7252.html
 推荐查看笑话：https://www.tianqi323.com/joke/7253.html
 推荐查看笑话：https://www.tianqi323.com/joke/7254.html
 推荐查看笑话：https://www.tianqi323.com/joke/7255.html
 推荐查看笑话：https://www.tianqi323.com/joke/7256.html
 推荐查看笑话：https://www.tianqi323.com/joke/7257.html
 推荐查看笑话：https://www.tianqi323.com/joke/7258.html
 推荐查看笑话：https://www.tianqi323.com/joke/7259.html
 推荐查看笑话：https://www.tianqi323.com/joke/7260.html
 推荐查看笑话：https://www.tianqi323.com/joke/7261.html
 推荐查看笑话：https://www.tianqi323.com/joke/7262.html
 推荐查看笑话：https://www.tianqi323.com/joke/7263.html
 推荐查看笑话：https://www.tianqi323.com/joke/7264.html
 推荐查看笑话：https://www.tianqi323.com/joke/7265.html
 推荐查看笑话：https://www.tianqi323.com/joke/7266.html
 推荐查看笑话：https://www.tianqi323.com/joke/7267.html
 推荐查看笑话：https://www.tianqi323.com/joke/7268.html
 推荐查看笑话：https://www.tianqi323.com/joke/7269.html
 推荐查看笑话：https://www.tianqi323.com/joke/7270.html
 推荐查看笑话：https://www.tianqi323.com/joke/7271.html
 推荐查看笑话：https://www.tianqi323.com/joke/7272.html
 推荐查看笑话：https://www.tianqi323.com/joke/7273.html
 推荐查看笑话：https://www.tianqi323.com/joke/7274.html
 推荐查看笑话：https://www.tianqi323.com/joke/7275.html
 推荐查看笑话：https://www.tianqi323.com/joke/7276.html
 推荐查看笑话：https://www.tianqi323.com/joke/7277.html
 推荐查看笑话：https://www.tianqi323.com/joke/7278.html
 推荐查看笑话：https://www.tianqi323.com/joke/7279.html
 推荐查看笑话：https://www.tianqi323.com/joke/7280.html
 推荐查看笑话：https://www.tianqi323.com/joke/7281.html
 推荐查看笑话：https://www.tianqi323.com/joke/7282.html
 推荐查看笑话：https://www.tianqi323.com/joke/7283.html
 推荐查看笑话：https://www.tianqi323.com/joke/7284.html
 推荐查看笑话：https://www.tianqi323.com/joke/7285.html
 推荐查看笑话：https://www.tianqi323.com/joke/7286.html
 推荐查看笑话：https://www.tianqi323.com/joke/7287.html
 推荐查看笑话：https://www.tianqi323.com/joke/7288.html
 推荐查看笑话：https://www.tianqi323.com/joke/7289.html
 推荐查看笑话：https://www.tianqi323.com/joke/7290.html
 推荐查看笑话：https://www.tianqi323.com/joke/7291.html
 推荐查看笑话：https://www.tianqi323.com/joke/7292.html
 推荐查看笑话：https://www.tianqi323.com/joke/7293.html
 推荐查看笑话：https://www.tianqi323.com/joke/7294.html
 推荐查看笑话：https://www.tianqi323.com/joke/7295.html
 推荐查看笑话：https://www.tianqi323.com/joke/7296.html
 推荐查看笑话：https://www.tianqi323.com/joke/7297.html
 推荐查看笑话：https://www.tianqi323.com/joke/7298.html
 推荐查看笑话：https://www.tianqi323.com/joke/7299.html
 推荐查看笑话：https://www.tianqi323.com/joke/7300.html
 推荐查看笑话：https://www.tianqi323.com/joke/7301.html
 推荐查看笑话：https://www.tianqi323.com/joke/7302.html
 推荐查看笑话：https://www.tianqi323.com/joke/7303.html
 推荐查看笑话：https://www.tianqi323.com/joke/7304.html
 推荐查看笑话：https://www.tianqi323.com/joke/7305.html
 推荐查看笑话：https://www.tianqi323.com/joke/7306.html
 推荐查看笑话：https://www.tianqi323.com/joke/7307.html
 推荐查看笑话：https://www.tianqi323.com/joke/7308.html
 推荐查看笑话：https://www.tianqi323.com/joke/7309.html
 推荐查看笑话：https://www.tianqi323.com/joke/7310.html
 推荐查看笑话：https://www.tianqi323.com/joke/7311.html
 推荐查看笑话：https://www.tianqi323.com/joke/7312.html
 推荐查看笑话：https://www.tianqi323.com/joke/7313.html
 推荐查看笑话：https://www.tianqi323.com/joke/7314.html
 推荐查看笑话：https://www.tianqi323.com/joke/7315.html
 推荐查看笑话：https://www.tianqi323.com/joke/7316.html
 推荐查看笑话：https://www.tianqi323.com/joke/7317.html
 推荐查看笑话：https://www.tianqi323.com/joke/7318.html
 推荐查看笑话：https://www.tianqi323.com/joke/7319.html
 推荐查看笑话：https://www.tianqi323.com/joke/7320.html
 推荐查看笑话：https://www.tianqi323.com/joke/7321.html
 推荐查看笑话：https://www.tianqi323.com/joke/7322.html
 推荐查看笑话：https://www.tianqi323.com/joke/7323.html
 推荐查看笑话：https://www.tianqi323.com/joke/7324.html
 推荐查看笑话：https://www.tianqi323.com/joke/7325.html
 推荐查看笑话：https://www.tianqi323.com/joke/7326.html
 推荐查看笑话：https://www.tianqi323.com/joke/7327.html
 推荐查看笑话：https://www.tianqi323.com/joke/7328.html
 推荐查看笑话：https://www.tianqi323.com/joke/7329.html
 推荐查看笑话：https://www.tianqi323.com/joke/7330.html
 推荐查看笑话：https://www.tianqi323.com/joke/7331.html
 推荐查看笑话：https://www.tianqi323.com/joke/7332.html
 推荐查看笑话：https://www.tianqi323.com/joke/7333.html
 推荐查看笑话：https://www.tianqi323.com/joke/7334.html
 推荐查看笑话：https://www.tianqi323.com/joke/7335.html
 推荐查看笑话：https://www.tianqi323.com/joke/7336.html
 推荐查看笑话：https://www.tianqi323.com/joke/7337.html
 推荐查看笑话：https://www.tianqi323.com/joke/7338.html
 推荐查看笑话：https://www.tianqi323.com/joke/7339.html
 推荐查看笑话：https://www.tianqi323.com/joke/7340.html
 推荐查看笑话：https://www.tianqi323.com/joke/7341.html
 推荐查看笑话：https://www.tianqi323.com/joke/7342.html
 推荐查看笑话：https://www.tianqi323.com/joke/7343.html
 推荐查看笑话：https://www.tianqi323.com/joke/7344.html
 推荐查看笑话：https://www.tianqi323.com/joke/7345.html
 推荐查看笑话：https://www.tianqi323.com/joke/7346.html
 推荐查看笑话：https://www.tianqi323.com/joke/7347.html
 推荐查看笑话：https://www.tianqi323.com/joke/7348.html
 推荐查看笑话：https://www.tianqi323.com/joke/7349.html
 推荐查看笑话：https://www.tianqi323.com/joke/7350.html
 推荐查看笑话：https://www.tianqi323.com/joke/7351.html
 推荐查看笑话：https://www.tianqi323.com/joke/7352.html
 推荐查看笑话：https://www.tianqi323.com/joke/7353.html
 推荐查看笑话：https://www.tianqi323.com/joke/7354.html
 推荐查看笑话：https://www.tianqi323.com/joke/7355.html
 推荐查看笑话：https://www.tianqi323.com/joke/7356.html
 推荐查看笑话：https://www.tianqi323.com/joke/7357.html
 推荐查看笑话：https://www.tianqi323.com/joke/7358.html
 推荐查看笑话：https://www.tianqi323.com/joke/7359.html
 推荐查看笑话：https://www.tianqi323.com/joke/7360.html
 推荐查看笑话：https://www.tianqi323.com/joke/7361.html
 推荐查看笑话：https://www.tianqi323.com/joke/7362.html
 推荐查看笑话：https://www.tianqi323.com/joke/7363.html
 推荐查看笑话：https://www.tianqi323.com/joke/7364.html
 推荐查看笑话：https://www.tianqi323.com/joke/7365.html
 推荐查看笑话：https://www.tianqi323.com/joke/7366.html
 推荐查看笑话：https://www.tianqi323.com/joke/7367.html
 推荐查看笑话：https://www.tianqi323.com/joke/7368.html
 推荐查看笑话：https://www.tianqi323.com/joke/7369.html
 推荐查看笑话：https://www.tianqi323.com/joke/7370.html
 推荐查看笑话：https://www.tianqi323.com/joke/7371.html
 推荐查看笑话：https://www.tianqi323.com/joke/7372.html
 推荐查看笑话：https://www.tianqi323.com/joke/7373.html
 推荐查看笑话：https://www.tianqi323.com/joke/7374.html
 推荐查看笑话：https://www.tianqi323.com/joke/7375.html
 推荐查看笑话：https://www.tianqi323.com/joke/7376.html
 推荐查看笑话：https://www.tianqi323.com/joke/7377.html
 推荐查看笑话：https://www.tianqi323.com/joke/7378.html
 推荐查看笑话：https://www.tianqi323.com/joke/7379.html
 推荐查看笑话：https://www.tianqi323.com/joke/7380.html
 推荐查看笑话：https://www.tianqi323.com/joke/7381.html
 推荐查看笑话：https://www.tianqi323.com/joke/7382.html
 推荐查看笑话：https://www.tianqi323.com/joke/7383.html
 推荐查看笑话：https://www.tianqi323.com/joke/7384.html
 推荐查看笑话：https://www.tianqi323.com/joke/7385.html
 推荐查看笑话：https://www.tianqi323.com/joke/7386.html
 推荐查看笑话：https://www.tianqi323.com/joke/7387.html
 推荐查看笑话：https://www.tianqi323.com/joke/7388.html
 推荐查看笑话：https://www.tianqi323.com/joke/7389.html
 推荐查看笑话：https://www.tianqi323.com/joke/7390.html
 推荐查看笑话：https://www.tianqi323.com/joke/7391.html
 推荐查看笑话：https://www.tianqi323.com/joke/7392.html
 推荐查看笑话：https://www.tianqi323.com/joke/7393.html
 推荐查看笑话：https://www.tianqi323.com/joke/7394.html
 推荐查看笑话：https://www.tianqi323.com/joke/7395.html
 推荐查看笑话：https://www.tianqi323.com/joke/7396.html
 推荐查看笑话：https://www.tianqi323.com/joke/7397.html
 推荐查看笑话：https://www.tianqi323.com/joke/7398.html
 推荐查看笑话：https://www.tianqi323.com/joke/7399.html
 推荐查看笑话：https://www.tianqi323.com/joke/7400.html
 推荐查看笑话：https://www.tianqi323.com/joke/7401.html
 推荐查看笑话：https://www.tianqi323.com/joke/7402.html
 推荐查看笑话：https://www.tianqi323.com/joke/7403.html
 推荐查看笑话：https://www.tianqi323.com/joke/7404.html
 推荐查看笑话：https://www.tianqi323.com/joke/7405.html
 推荐查看笑话：https://www.tianqi323.com/joke/7406.html
 推荐查看笑话：https://www.tianqi323.com/joke/7407.html
 推荐查看笑话：https://www.tianqi323.com/joke/7408.html
 推荐查看笑话：https://www.tianqi323.com/joke/7409.html
 推荐查看笑话：https://www.tianqi323.com/joke/7410.html
 推荐查看笑话：https://www.tianqi323.com/joke/7411.html
 推荐查看笑话：https://www.tianqi323.com/joke/7412.html
 推荐查看笑话：https://www.tianqi323.com/joke/7413.html
 推荐查看笑话：https://www.tianqi323.com/joke/7414.html
 推荐查看笑话：https://www.tianqi323.com/joke/7415.html
 推荐查看笑话：https://www.tianqi323.com/joke/7416.html
 推荐查看笑话：https://www.tianqi323.com/joke/7417.html
 推荐查看笑话：https://www.tianqi323.com/joke/7418.html
 推荐查看笑话：https://www.tianqi323.com/joke/7419.html
 推荐查看笑话：https://www.tianqi323.com/joke/7420.html
 推荐查看笑话：https://www.tianqi323.com/joke/7421.html
 推荐查看笑话：https://www.tianqi323.com/joke/7422.html
 推荐查看笑话：https://www.tianqi323.com/joke/7423.html
 推荐查看笑话：https://www.tianqi323.com/joke/7424.html
 推荐查看笑话：https://www.tianqi323.com/joke/7425.html
 推荐查看笑话：https://www.tianqi323.com/joke/7426.html
 推荐查看笑话：https://www.tianqi323.com/joke/7427.html
 推荐查看笑话：https://www.tianqi323.com/joke/7428.html
 推荐查看笑话：https://www.tianqi323.com/joke/7429.html
 推荐查看笑话：https://www.tianqi323.com/joke/7430.html
 推荐查看笑话：https://www.tianqi323.com/joke/7431.html
 推荐查看笑话：https://www.tianqi323.com/joke/7432.html
 推荐查看笑话：https://www.tianqi323.com/joke/7433.html
 推荐查看笑话：https://www.tianqi323.com/joke/7434.html
 推荐查看笑话：https://www.tianqi323.com/joke/7435.html
 推荐查看笑话：https://www.tianqi323.com/joke/7436.html
 推荐查看笑话：https://www.tianqi323.com/joke/7437.html

在 Node.js 里读取文件时，fs.readFile 和 fs.createReadStream 是最常被拿来比较的两个 API。很多接口在本地开发时用 readFile 跑得好好的，一上线遇到几十 MB 的日志文件或用户上传的压缩包，进程内存就迅速上涨，甚至直接 OOM。原因并不复杂：readFile 会把整个文件一次性读进内存再回调给你，而 createReadStream 基于流和缓冲区逐块读取，天然带背压控制。但流也不是银弹，错误处理、文件描述符关闭、编码转换都有坑。这篇文章从实际代码出发，聊清楚两者在内存占用、错误传播和资源释放上的差异，以及什么时候该用哪个。

Node.js 中 fs.readFile 与 fs.createReadStream 到底该选哪个？从内存、背压和错误处理说起

在 Node.js 里读取文件时，fs.readFile 和 fs.createReadStream 是最常被拿来比较的两个 API。很多接口在本地开发时用 readFile 跑得好好的，一上线遇到几十 MB 的日志文件或用户上传的压缩包，进程内存就迅速上涨，甚至直接 OOM。原因并不复杂：readFile 会把整个文件一次性读进内存再回调给你，而 createReadStream 基于流和缓冲区

人工智能

Node.js读取大文件时，fs.readFile一次性加载易致内存溢出，createReadStream基于流式背压控制更优。文章对比两者内存占用、错误传播与资源释放差异，详解pipeline管理、highWaterMark调优、readline处理文本行及编码边界问题。小文件选readFile，不可控大文件用createReadStream，避免文件描述符泄漏。

图像处理

日志文件

代码解释

Windows

容器

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Node.js读取大文件时，fs.readFile一次性加载易致内存溢出，createReadStream基于流式背压控制更优。文章对比两者内存占用、错误传播与资源释放差异，详解pipeline管理、highWaterMark调优、readline处理文本行及编码边界问题。小文件选readFile，不可控大文件用cre...

Node.js 中 fs.readFile 与 fs.createReadStream 到底该选哪个？从内存、背压和错误处理说起-腾讯云开发者社区-腾讯云

Node.js 中 fs.readFile 与 fs.createReadStream 到底该选哪个？从内存、背压和错误处理说起

Node.js 中 fs.readFile 与 fs.createReadStream 到底该选哪个？从内存、背压和错误处理说起

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐