
纯前端 html 文件无法直接读取本地 sqlite(.db)文件;浏览器安全策略禁止自动访问磁盘文件。可行方案是使用 electron 等桌面应用框架——它允许 javascript 安全访问本地文件系统,同时复用 html/css/js 技术栈构建跨平台桌面应用。
纯前端 html 文件无法直接读取本地 sqlite(.db)文件;浏览器安全策略禁止自动访问磁盘文件。可行方案是使用 electron 等桌面应用框架——它允许 javascript 安全访问本地文件系统,同时复用 html/css/js 技术栈构建跨平台桌面应用。
构建一个完全离线、无需配置 Web 服务器、又能动态查询 SQLite 数据库并渲染故事列表的本地应用,是可行的——但关键在于不依赖传统浏览器沙箱环境。标准的 file:// 协议下打开的 HTML 页面受严格同源与文件系统限制:fetch('data.db') 或 fs.readFileSync() 均会失败;IndexedDB 或 WebSQL 也无法直接导入外部 .db 文件。
✅ 正确路径:采用 Electron(推荐 v28+)
Electron 将 Chromium 渲染进程与 Node.js 运行时融合,使前端代码可调用 sqlite3 原生模块,直接读写本地 .db 文件:
# 初始化项目 npm init -y npm install electron sqlite3 --save-dev
// main.js(主进程)
const { app, BrowserWindow } = require('electron')
const path = require('path')
const sqlite3 = require('sqlite3').verbose()
function createWindow() {
const win = new BrowserWindow({
width: 1024,
height: 768,
webPreferences: {
nodeIntegration: true, // 启用 Node.js API
contextIsolation: false, // 允许 renderer 访问 require
enableRemoteModule: false
}
})
win.loadFile('index.html')
}
app.whenReady().then(createWindow)<!-- index.html -->
<!DOCTYPE html>
<html>
<head><title>我的故事库</title></head>
<body>
<h1>作者列表</h1>
<ul id="authors"></ul>
<script>
const sqlite3 = require('sqlite3').verbose()
const db = new sqlite3.Database('./stories.db') // ✅ 可直接访问同目录 .db
db.all("SELECT DISTINCT author FROM stories ORDER BY author", (err, rows) => {
if (err) throw err
const ul = document.getElementById('authors')
rows.forEach(row => {
const li = document.createElement('li')
li.innerHTML = `<a href="#" onclick="showStories('${row.author}')">${row.author}</a>`
ul.appendChild(li)
})
})
window.showStories = (author) => {
db.all("SELECT title, summary, filepath FROM stories WHERE author = ?", [author], (err, rows) => {
document.body.innerHTML = `
<h2>作者:${author}</h2>
<ul>${rows.map(r =>
`<li><a href="${r.filepath}" target="_blank">${r.title}</a> — ${r.summary}</li>`
).join('')}</ul>
<p><a href="index.html">← 返回作者列表</a></p>
`
})
}
</script>
</body>
</html>⚠️ 注意事项:
-
安全性:因应用仅本地运行,无需担忧远程注入,但仍建议对 SQL 查询使用参数化语句(如示例中的
?占位符),避免拼接用户输入; -
分发便捷性:使用
electron-packager打包为.exe(Windows)、.app(macOS)或.AppImage(Linux),好友双击即可运行,零配置; - 替代轻量方案:若追求极简,可考虑 Tauri(Rust 后端 + WebView 前端),体积更小、权限更精细,但学习曲线略高;
-
不可行方案排除:
❌ 直接双击index.html→ 浏览器拒绝读取.db;
❌ 使用sqlite-wasm(如 sql.js)→ 仅支持内存加载,需用户手动拖入.db文件,无法自动读取磁盘;
❌ Python Flask/PHP → 违背“免服务器”初衷,需额外安装运行时。
总结:放弃“纯静态网页”幻想,拥抱 Electron 这类桌面容器——它让你用熟悉的 Web 技术,获得原生应用的文件系统权限。你的故事库将变成一个独立、可分发、点击即用的本地应用,完美契合“给朋友一键使用”的核心需求。


















