Electron无法直连GridFS离线工作，因其依赖MongoDB服务端集合和活跃连接；可行方案是下载GridFS文件流并持久化到本地文件系统（如userData目录），通过IPC安全读取，同时需标准化文件名、校验MD5防损坏。
Electron 应用无法直接离线访问 MongoDB GridFS 文件——GridFS 本身是服务端机制，所有读写都依赖 MongoDB 实例和网络连接。所谓“离线缓存”，实际是指：在 Electron 客户端本地持久化已下载的 GridFS 文件内容（如 PDF、图片、压缩包），并在无网络时直接读取本地副本。
为什么不能让 Electron 直连 GridFS 离线工作
GridFS 不是客户端存储方案，它依赖两个服务端集合 fs.files 和 fs.chunks，所有操作（openDownloadStream、find、delete）都需发起 MongoDB 查询。Electron 主进程或渲染进程无法绕过驱动直读 GridFS 的 BSON 块结构；更关键的是，GridFSBucket 实例必须绑定活跃的 MongoClient，断网即抛出连接错误（如 Network timeout 或 getaddrinfo ENOTFOUND）。
可行路径：下载后落地到本地文件系统
真正可落地的“离线缓存”，是把 GridFS 中的文件流下载下来，保存为普通文件（如 app.getPath('userData')/gridfs-cache/task-guide.pdf），后续读取完全走 Node.js 的 fs.readFile 或 createReadStream。
- 首次加载时调用
bucket.openDownloadStreamById(fileId)获取流，用fs.createWriteStream(localPath)写入磁盘 - 写入完成后记录元数据（
fileId、filename、lastModified、localPath）到本地 SQLite 或 JSON 文件，供离线查询 - 后续请求先查本地缓存是否存在且未过期，存在则跳过网络请求，直接读
localPath - 可配合
app.whenReady()预热常用文件，或监听online/offline事件触发同步逻辑
Electron 渲染进程里怎么安全读本地文件
渲染进程默认禁用 Node.js API，直接 require('fs') 会报错。必须通过预加载脚本（preload.cjs）暴露受限接口：
const { contextBridge, ipcRenderer } = require('electron')
const fs = require('fs').promises
const path = require('path')
contextBridge.exposeInMainWorld('fsCache', {
readFile: async (relPath) => {
const fullPath = path.join(app.getPath('userData'), 'gridfs-cache', relPath)
// 加白名单校验，防止路径遍历
if (!fullPath.startsWith(app.getPath('userData'))) throw new Error('Invalid path')
return await fs.readFile(fullPath)
}
})
然后在渲染进程里调用 window.fsCache.readFile('report.pdf')。注意：不要暴露 writeFile 或 rm 给前端，写操作应由主进程统一管控。
容易被忽略的细节
GridFS 文件名可能含非法字符（如 /、..、空格），直接拼进 localPath 会导致写入失败或覆盖；fs.files.filename 是服务端原始值，不等于你本地保存的路径名。必须做标准化处理：filename.replace(/[/\?%*:|"]/g, '_')。另外，GridFS 本身不保证文件完整性（比如 chunk 丢失不会自动报错），下载后建议比对 fs.files.md5 和本地文件 hash，否则离线读到损坏文件就只能靠用户重试了。
