onerror无法捕获openDatabase失败，因其无错误回调、不触发window.onerror，且返回null或抛异常行为不统一；需用try-catch、判null、事务校验等组合方式定位错误。
HTML5 中的 Web SQL Database（已废弃）曾提供 openDatabase 方法，但它本身**不支持直接通过 onerror 监控数据库打开失败**——该方法没有标准的错误回调参数，也未定义全局或实例级的 onerror 事件处理器。
为什么 onerror 无法用于 openDatabase 失败捕获
Web SQL 的 openDatabase 是同步返回数据库对象（或抛出异常），但实际行为依赖浏览器实现：
- 在旧版 Chrome/Safari 中，若数据库打开失败（如配额超限、非法名称），
openDatabase可能静默返回null，不抛错也不触发window.onerror； - 它不接受回调函数，也没有类似
onsuccess/onerror的事件监听接口； -
window.onerror主要捕获 JavaScript 运行时错误、资源加载失败等，不拦截底层数据库初始化异常。
可行的异常定位方式
需结合主动检测 + try-catch + 状态校验：
Article To Html
下载
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
-
用 try-catch 包裹 openDatabase 调用：部分浏览器（如 Safari）会在非法参数（如空库名、超长版本号）时抛出
SyntaxError或DOMException； -
检查返回值是否为 null：若
openDatabase(...)返回null，通常表示被拒绝（如用户禁用数据库、配额不足），此时可记录上下文； -
执行简单事务并监听 transaction.onerror：即使数据库对象获取成功，首次
transaction执行时可能暴露真实错误（如磁盘满、权限问题），这是最可靠的失败信号； - 配合 navigator.onLine 和存储配额 API（如 storage.estimate()）做前置判断：减少不可控失败场景。
示例：稳健的打开与错误定位
（注意：Web SQL 已被现代浏览器逐步弃用，仅作兼容性参考）
立即学习“前端免费学习笔记（深入）”；
function safeOpenDB(name, version, desc, size) {
let db;
try {
db = openDatabase(name, version, desc, size);
} catch (e) {
console.error('openDatabase 抛异常:', e.name, e.message);
return null;
}
if (!db) {
console.warn('openDatabase 返回 null，可能因配额不足或被阻止');
return null;
}
// 主动触发一次最小事务验证可用性
db.transaction(tx => {
tx.executeSql('SELECT 1', [], () => {}, (tx, err) => {
console.error('数据库首次事务失败:', err.code, err.message);
// err.code 常见值：0=UNKNOWN_ERR, 1=DATABASE_ERR, 2=VERSION_ERR 等
});
});
return db;
}
更推荐的现代替代方案
Web SQL 已被 W3C 废弃，新项目应迁移到：
-
IndexedDB：原生支持
onsuccess/onerror事件，错误码明确（如VersionError、AbortError），且有完整 Promise 封装（如 idb 库）； - localStorage/sessionStorage：适用于简单键值场景，读写失败可通过 try-catch 捕获 QuotaExceededError；
- Web Storage + 后端同步：敏感或大数据量场景，优先本地缓存，再异步落库。
