WebSQL 已被主流浏览器弃用，openDatabase 在 Chrome 98+、Edge 108+、Safari 16.4+ 中默认禁用，HTTP 下静默失败，跨域或非 localhost 触发 SecurityError；应迁移到 IndexedDB，其为 W3C 标准、全平台支持、异步且具备事务与索引能力。
WebSQL 已被主流浏览器弃用，openDatabase 在 Chrome 98+、Edge 108+、Safari 16.4+ 中默认禁用，且无替代 polyfill；当前无法通过标准 WebSQL API 可靠读取本地数据库。
为什么 openDatabase 现在大概率会失败
Chrome 和 Edge 从新版起将 WebSQL 标记为“deprecated”，调用 openDatabase 时控制台会输出警告，部分站点（尤其是非 localhost 或非 HTTPS）直接拒绝创建连接；Safari 虽仍支持，但仅限于 iOS/iPadOS 的 WebView 内部，且不保证长期可用。
- HTTP 协议下（非 HTTPS）调用
openDatabase会被静默忽略 - localhost 以外的域名 + HTTP →
SecurityError或返回null - 即使成功打开，
transaction().executeSql()查询可能因权限策略被中断
替代方案：改用 IndexedDB 读取结构化本地数据
IndexedDB 是 W3C 标准、全浏览器支持、异步、支持事务与索引，是 WebSQL 的官方继任者。迁移核心在于把 SQL 查询转为对象存储操作。
-
openDatabase('mydb', 1)→ 改为indexedDB.open('mydb', 1) - 建表逻辑（
CREATE TABLE）→ 改为objectStore.createIndex()或版本升级中新建objectStore -
SELECT * FROM users WHERE age > 25→ 改为index.openCursor(IDBKeyRange.lowerBound(25))
const request = indexedDB.open('mydb', 1);
request.onsuccess = function(e) {
const db = e.target.result;
const tx = db.transaction('users', 'readonly');
const store = tx.objectStore('users');
const index = store.index('age');
const cursorRequest = index.openCursor(IDBKeyRange.lowerBound(25));
cursorRequest.onsuccess = function(e) {
const cursor = e.target.result;
if (cursor) {
console.log(cursor.value); // { name: 'Alice', age: 30 }
cursor.continue();
}
};
};如果必须兼容遗留 WebSQL 代码（极少数内网场景）
仅限已部署的老系统维护，且确认运行环境可控（如 Electron、特定版本 Chromium 嵌入式壳、或 Safari 15–16.3 的 iOS WebView）。
立即学习“前端免费学习笔记（深入）”；
- 检查是否真有数据库存在：
if (window.openDatabase) { ... } - 务必捕获
error回调，而非只依赖success—— 失败时transaction可能为undefined - 避免使用
INSERT OR REPLACE等 SQLite 特有语法，它在部分旧版 WebSQL 实现中不被识别
const db = openDatabase('test', '1.0', 'test db', 2 * 1024 * 1024);
db.transaction(function(tx) {
tx.executeSql('SELECT * FROM logs', [], function(tx, results) {
for (let i = 0; i < results.rows.length; i++) {
console.log(results.rows.item(i));
}
}, function(tx, err) {
console.error('Query failed:', err.message); // 必须加 error handler
});
});WebSQL 不是“还能用但不推荐”，而是“多数环境已不可用”。真正要读本地结构化数据，IndexedDB 是唯一现实选择；任何新项目都不该再设计 WebSQL 依赖路径。
