Node.js readFile 读文件描述符：文件没变，为什么第二次只读到空串
同一个小文件先检查两字节的头部，再把文件描述符交给 readFile，希望得到完整内容，结果开头两字节不见了。再次调用又只返回空串。文件没有被删改，变化的是已打开文件的读取位置：接口会接着当前位置读下去。
传路径和传描述符不是相同入口
按文件路径读取时，接口自行打开文件；传入已有描述符时，调用者已经提供了一个带状态的打开资源。Node.js 文档明确说明，这种读取从当前位置开始，并且不会替调用者自动关闭描述符。内容范围与关闭责任都随入口变化。
下面创建一份只有六个 ASCII 字符的临时文件。先用位置为 null 的 readSync 消费两个字节，再通过回调版 readFile 读取剩余内容。外面的小 Promise 包装只是让步骤按顺序等待，不改变传入描述符的读取规则。
保存为 demo.mjs，执行 node demo.mjs。临时目录由程序独立创建，最终只清理本次创建的目录；示例不会接触现有业务文件。同步读取仅用于这个六字节实验，不是长文件服务的吞吐建议。
配图为 AI 生成的概念插图，用抽象物件说明本文关系，并非真实软件截图或运行输出。
import assert from 'node:assert/strict';
import fs from 'node:fs';
import os from 'node:os';
import path from 'node:path';
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'read-pos-'));
const file = path.join(dir, 'sample.txt');
let fd;
const readRest = handle => new Promise((resolve, reject) => {
fs.readFile(handle, 'utf8', (error, data) => {
if (error) reject(error);
else resolve(data);
});
});
try {
fs.writeFileSync(file, 'ABCDEF');
fd = fs.openSync(file, 'r');
const head = Buffer.alloc(2);
assert.equal(fs.readSync(fd, head, 0, 2, null), 2);
assert.equal(head.toString(), 'AB');
const rest = await readRest(fd);
const again = await readRest(fd);
assert.equal(rest, 'CDEF');
assert.equal(again, '');
assert.equal(fs.fstatSync(fd).size, 6);
const first = Buffer.alloc(1);
assert.equal(fs.readSync(fd, first, 0, 1, 0), 1);
assert.equal(first.toString(), 'A');
assert.equal(await readRest(fd), '');
assert.equal(fs.readFileSync(file, 'utf8'), 'ABCDEF');
console.log(JSON.stringify({head: head.toString(), rest, again}));
console.log('descriptor still open; explicit read did not rewind');
console.log('fresh path read: ABCDEF');
} finally {
try {
if (fd !== undefined) fs.closeSync(fd);
} finally {
fs.rmSync(dir, {recursive: true, force: true});
}
}空结果表示读到末尾，不表示文件为空
首行的 head 为 AB，rest 为 CDEF，again 为空串。两次 readFile 后，fstatSync 仍能读取文件大小六，说明描述符没有被自动关闭。仅从第二次结果为空推断磁盘文件已清空，会把偏移状态误判成数据损坏。
接下来把 readSync 的 position 明确设为零，虽然能再次得到 A，但不会把描述符当前偏移倒回开头。随后 readFile 仍为空。指定位置读取和重置默认读取位置是不同动作，不能拿一次成功的定点读取证明下一次顺序读取也从头开始。
最后按路径重新读，得到完整的 ABCDEF。这一对照排除了文件内容变化，让差异只落在打开资源的状态上。若确实需要从头消费整个文件，可以重新打开一个独立描述符；若只是检查固定头部，显式位置读取能避免消耗顺序读取位置。
同一个打开资源需要明确拥有者
函数接收描述符时，应约定它读多少、是否改变位置、谁负责关闭。不能一边把描述符借给别的组件，一边假设它还停在原处。多个异步读取若同时使用同一位置状态，还可能相互影响，调用方应串行安排或使用明确位置的读取。
示例用 finally 关闭资源，并在关闭结束后清理临时目录；实际封装也应把失败路径纳入资源管理。readFile 的成功回调只说明本次读取完成，不代表调用者持有的描述符生命周期已经结束。不要等待运行时碰巧回收来替代明确关闭。
这里用 ASCII 避免把字节位置与字符位置混在一起。真实 UTF-8 文件若先消费了半个多字节字符，再把剩余字节直接解码，可能出现替换字符；那属于额外的编码边界，需要按协议确定读取单位。先记录偏移、字节数和入口类型，才能准确复现问题。
资料核对日期：2026年10月2日（北京时间）。最终展示代码在 Node.js v24.19.0、Linux 环境中独立运行并通过全部断言。
