本文详解 Expo SQLite 中 tx.executeSql 无报错但数据未写入的典型问题，涵盖 SDK 版本兼容性、跨平台类型差异、事务执行机制及调试技巧，助你快速定位并修复数据持久化失败问题。
本文详解 expo sqlite 中 `tx.executesql` 无报错但数据未写入的典型问题，涵盖 sdk 版本兼容性、跨平台类型差异、事务执行机制及调试技巧，助你快速定位并修复数据持久化失败问题。
在使用 Expo SQLite（尤其是 expo-sqlite）进行本地数据库操作时，开发者常遇到一种“静默失败”现象：tx.executeSql() 调用不抛异常、控制台无错误日志，但数据始终未写入表中——你的 rexpenses 表创建成功、setRecurringExpense 函数正常执行，却查不到插入记录。这并非代码逻辑错误，而是由 Expo 生态中几个关键兼容性与实现细节导致的。
✅ 核心原因分析与对应修复
1. SDK 49+ 与远程调试（Remote JS Debugging）冲突
自 Expo SDK 49 起，Android 端在启用 Chrome 远程调试 时，底层 JavaScriptCore（JSC）引擎与 SQLite 原生模块存在线程 / 上下文兼容性问题，导致事务提交失败（executeSql 实际未触发 COMMIT）。该问题在 iOS 上通常不明显，但在 Android 模拟器或真机调试时高频出现。
✅ 解决方案：
- 临时禁用远程调试：关闭 Chrome DevTools → 在 Expo Go App 中下拉菜单 → 关闭 Debug；
- 或改用 React Native Debugger（独立应用，兼容性更优）；
- 长期建议升级至 expo-sqlite@~12.0.0+（适配 Hermes + 新版 JSC），并确保 expo-dev-client 配置正确。
2. 跨平台数据类型不兼容（尤其 DATETIME 字段）
你的建表语句中定义了 recurrancedate DATETIME，并在插入时传入 JavaScript Date 对象（如 new Date(…)）。SQLite 本身 不原生支持 DATETIME 类型，它仅将值按字符串 / 数字 /NULL 存储。而 expo-sqlite 在 Android 和 iOS 上对 Date 对象的序列化行为不一致：
- iOS 可能自动调用 .toString() 得到 “Mon Apr 01 2024…”；
- Android 则可能传入 [object Date] 或 NaN，导致插入失败（静默跳过）。
✅ 正确做法：统一转为 ISO 字符串格式
// ✅ 安全写法：显式转换为 ISO 8601 字符串 const recurranceDate = new Date(/* …… */).toISOString(); // e.g., "2024-04-01T08:30:00.000Z" // 插入时保持字符串类型 tx.executeSql( "INSERT INTO rexpenses (name, amount, category, recurrancedate, repeattype) VALUES (?, ?, ?, ?, ?)", [expense.Name, expense.Amount, expense.Category, recurranceDate, // ← 传入字符串，非 Date 对象 recurringInterval], (_, { insertId, rowsAffected}) => {console.log(`Inserted recurring expense ID: ${insertId}`); }, (_, error) => {console.error("SQL INSERT failed:", error.message, error.code); } );⚠️ 注意：SQLite 中日期建议统一存为 TEXT（ISO 格式）或 INTEGER（Unix 时间戳），避免使用 DATETIME 类型声明——它仅是语义提示，无类型校验能力。
3. 事务未正确完成：缺少 COMMIT 或回调链断裂
expo-sqlite 的 transaction() 方法要求 所有 SQL 执行必须在回调内完成，且需确保：
- 成功回调（第 3 参数）和失败回调（第 4 参数）均被定义；
- 若任一 SQL 报错，整个事务会自动回滚，但若失败回调未 console.error 或吞掉错误，易被忽略。
✅ 强化事务健壮性写法：
db.transaction((tx) => {tx.executeSql( "INSERT INTO rexpenses (……) VALUES (?, ?, ?, ?, ?)", [/* …… */], (_, result) => {console.log("✅ Insert succeeded:", result.insertId); }, (txObj, error) => {console.error("❌ Transaction failed at SQL level:", error.message); return true; // ← 必须返回 true 触发 rollback } ); }, (error) => {console.error("❌ Transaction-level error:", error.message); // ← 全局事务错误 }, () => { console.log("✅ Transaction committed successfully"); // ← 显式确认提交 } );? 调试验证步骤（必做）
-
检查表结构是否真创建成功：
db.transaction(tx => { tx.executeSql("SELECT name FROM sqlite_master WHERE type='table' AND name='rexpenses';", [], (_, { rows}) => console.log("Tables found:", rows._array) ); }); -
查询空表确认初始化状态：
db.transaction(tx => { tx.executeSql("SELECT * FROM rexpenses;", [], (_, { rows}) => console.log("Current rows:", rows._array) ); }); -
强制刷新数据库路径（开发期）：
在 App.js 开头添加（仅开发用）：import * as FileSystem from 'expo-file-system'; // 删除旧 DB 强制重建 await FileSystem.deleteAsync(FileSystem.documentDirectory + 'SQLite/rexpenses.db');
✅ 总结：最佳实践清单
- ✅ 始终将 Date 对象转为 .toISOString() 字符串再入库；
- ✅ 避免使用 DATETIME 类型，建表时声明为 TEXT；
- ✅ 关闭远程调试（尤其 Android）测试是否恢复；
- ✅ 为 transaction() 显式提供 success/failure 回调，并返回 true 触发回滚；
- ✅ 使用 rowsAffected > 0 或 insertId 而非仅依赖 console.log 判断成功；
- ✅ 升级至 expo-sqlite@^12.0.0 + expo@^49.0.0 并启用 Hermes。
遵循以上方案，95% 的 executeSql 静默失败问题可立即解决。数据库操作应“可见、可测、可回溯”，切勿依赖无日志的成功假象。
