
node.js 的 `fs` 模块本身不会缓存文件系统数据,所谓“不刷新”通常源于业务逻辑层的数据不一致(如数据库未同步、变量复用或状态未更新),而非底层文件读取问题。
在构建基于 node.js + EJS 的文件管理器时,你可能会遇到这样的现象:调用 fs.mkdirSync() 成功创建了新文件夹,但随后访问 /folders 接口返回的列表中却看不到它,必须重启服务才生效。这很容易被误认为是 fs.readdirSync() 缓存了结果,但实际上——node.js 的原生 fs 模块从不缓存磁盘 I/O 结果。每次调用 fs.readdirSync() 都会真实触发一次系统调用,读取当前时刻文件系统的快照。
真正的问题往往出在业务逻辑与数据源的同步缺失。正如你在调试后发现的:你的 /folders 路由并非直接依赖 fs.readdirSync() 的原始结果,而是先通过 Mongoose 查询用户已“注册”或“授权管理”的文件夹路径(例如存在 MongoDB 中的 UserFolder 文档),再结合 fs.readdirSync() 过滤/匹配这些路径。而 /create-folder 接口虽然成功创建了物理目录,却未及时将新路径写入数据库,或未在后续请求中重新拉取最新数据库记录 —— 导致前端看到的仍是旧的、不包含新文件夹的过滤结果。
✅ 正确做法示例(express + Mongoose):
// ✅ /create-folder 路由:创建目录 + 同步更新数据库 app.post('/create-folder', async (req, res) => { const { name } = req.body; const folderPath = path.join(BASE_DIR, name); try { fs.mkdirSync(folderPath, { recursive: true }); // 关键:立即保存到数据库,确保后续查询能命中 await UserFolder.create({ userId: req.user.id, path: folderPath, name }); res.status(201).json({ success: true, message: 'Folder created and registered.' }); } catch (err) { res.status(500).json({ error: err.message }); } }); // ✅ /folders 路由:每次请求都重新获取最新数据库记录 + 实时读取文件系统 app.get('/folders', async (req, res) => { try { // 每次请求都重新查库,避免内存缓存旧数据 const userFolders = await UserFolder.find({ userId: req.user.id }).select('path'); const folderPaths = userFolders.map(f => f.path); const entries = fs.readdirSync(BASE_DIR, { withFileTypes: true }); const filtered = entries.filter(entry => entry.isDirectory() && folderPaths.includes(path.join(BASE_DIR, entry.name)) ); res.json(filtered.map(e => ({ name: e.name, isDirectory: true }))); } catch (err) { res.status(500).json({ error: err.message }); } });
⚠️ 注意事项:
- 避免全局缓存数据库查询结果:不要将 userFolders 存在模块级变量或闭包中复用,务必在每次请求内执行新鲜查询;
- 路径一致性至关重要:确保数据库存储的 path 与 fs.readdirSync() 构建的比对路径完全一致(建议统一使用 path.resolve() 或 path.join() 规范化);
- 如需更高性能,可考虑引入轻量缓存(如 node-cache),但必须设置合理 TTL 并在创建/删除操作后主动 del() 对应 key;
- 开发阶段可加日志验证:在 /folders 路由开头打印 date.now() 和 userFolders.Length,确认是否真为数据库未更新所致。
总结:这不是 fs 的问题,而是「状态同步」问题。保持数据源(DB)与视图逻辑(FS + 业务规则)的一致性,才是实现实时文件管理的关键。