文章目录本地优先架构实践SQLite Repository 模式 自动备份为什么选择本地优先数据库设计Schema7 张表索引策略Repository 模式自动备份5 行代码的数据安全数据导出/导入JSON 导出JSON 导入最复杂的部分CSV 导出局限性总结本地优先架构实践SQLite Repository 模式 自动备份不联网、不注册、不上云。你的财务数据只存在你手机上。为什么选择本地优先做本地优先Local-First不是因为技术限制而是产品定位的刻意选择1. 隐私财务数据是最敏感的个人信息之一。你有多少存款、你的房子值多少、你的信用卡欠多少——这些信息不应该存在于任何第三方服务器上。WorthBase 不主动发起任何网络请求。2. 离线可用地铁里、飞机上、山区旅行——任何地方都能打开 App 查看和更新数据。不依赖网络状态。3. 数据所有权你的数据是你的。不存在服务商停止运营后数据丢失的问题。数据就是一个.db文件你可以随时复制、备份、迁移。数据库设计Schema7 张表-- 账户表8 种类型CREATETABLEaccounts(idTEXTPRIMARYKEY,nameTEXTNOTNULL,typeTEXTNOTNULL,-- wechat/alipay/bank_card/cash/fund/credit_card/loan/othericonTEXT,sort_orderINTEGERDEFAULT0,deleted_atTEXT,-- 软删除不物理删除created_atTEXT,updated_atTEXT);-- 余额快照表追加式不修改历史CREATETABLEbalance_snapshots(idTEXTPRIMARYKEY,account_idTEXTNOTNULLREFERENCESaccounts(id),balanceREALNOTNULL,snapshot_dateTEXTNOTNULL);-- 实物资产表8 种分类4 种分摊方式CREATETABLEassets(idTEXTPRIMARYKEY,nameTEXTNOTNULL,categoryTEXTNOTNULL,-- vehicle/real_estate/electronics/digital/home/luxury/precious_metal/otherpurchase_dateTEXTNOTNULL,purchase_priceREALNOTNULL,amortization_typeTEXTNOTNULL,expected_lifespan_monthsINTEGER,residual_valueREAL,valuation_trackingINTEGERDEFAULT0,current_valuationREAL,statusTEXTDEFAULTactive,-- active/retired/soldsell_dateTEXT,sell_priceREAL,weight_gramsREAL,image_pathTEXT,created_atTEXT,updated_atTEXT);-- 经常性支出保险、停车费等按月生效CREATETABLErecurring_expenses(idTEXTPRIMARYKEY,asset_idTEXTREFERENCESassets(id),nameTEXTNOTNULL,amountREALNOTNULL,effective_fromTEXTNOTNULL,effective_toTEXT,-- null 持续生效ended_reasonTEXT);-- 一次性维护记录维修、保养CREATETABLEmaintenance_records(idTEXTPRIMARYKEY,asset_idTEXTREFERENCESassets(id),nameTEXTNOTNULL,amountREALNOTNULL,dateTEXTNOTNULL,amortizeINTEGERDEFAULT0-- 是否纳入月均分摊);-- 估值历史可选追踪CREATETABLEvaluation_history(idTEXTPRIMARYKEY,asset_idTEXTREFERENCESassets(id),valuationREALNOTNULL,recorded_dateTEXTNOTNULL);-- 应用设置KV 存储CREATETABLEsettings(keyTEXTPRIMARYKEY,valueTEXTNOTNULL);索引策略针对高频查询场景建索引-- 余额快照按账户日期查询最新余额CREATEINDEXidx_snapshots_account_dateONbalance_snapshots(account_id,snapshot_date);-- 余额快照按日期查询趋势图数据CREATEINDEXidx_snapshots_dateONbalance_snapshots(snapshot_date);-- 经常性支出按生效区间查询当月有哪些支出生效CREATEINDEXidx_recurring_effectiveONrecurring_expenses(effective_from,effective_to);Repository 模式每个表对应一个 Repository 对象封装所有 SQL 操作// src/db/account-repository.ts (简化)exportconstAccountRepository{asyncgetAll():PromiseAccount[]{...},asynccreate(account:Account):Promisevoid{...},asyncupdate(id:string,updates:PartialAccount):Promisevoid{...},asyncsoftDelete(id:string):Promisevoid{...},// SET deleted_at now// 聚合查询获取所有账户的最新余额asyncgetAllLatestBalances():PromiseMapstring,number{constresultawaitdb.getAllAsync(SELECT bs.account_id, bs.balance FROM balance_snapshots bs INNER JOIN ( SELECT account_id, MAX(snapshot_date) as max_date FROM balance_snapshots GROUP BY account_id ) latest ON bs.account_id latest.account_id AND bs.snapshot_date latest.max_date INNER JOIN accounts a ON bs.account_id a.id WHERE a.deleted_at IS NULL);returnnewMap(result.map(r[r.account_id,r.balance]));},};没有 ORM没有 query builder纯 SQL。对于 7 张表的项目来说ORM 引入的抽象层比它解决的问题更多。自动备份5 行代码的数据安全本地优先 App 最大的风险是数据丢失——手机丢了、App 被卸载、数据库文件损坏。我的解决方案极其简单// app/_layout.tsx:58-66useEffect((){constsubscriptionAppState.addEventListener(change,(nextAppState){constprevappStateRef.current;appStateRef.currentnextAppState;// App 退到后台 → 自动备份if(prevactive(nextAppStatebackground||nextAppStateinactive)){BackupService.createBackup();}});return()subscription.remove();},[]);BackupService.createBackup()做的事情就是把 SQLite.db文件原封不动地复制到backups/目录文件名带时间戳。最多保留 3 份旧的自动删除。没有后台任务、没有定时器、没有推送通知。App 退后台就备份就这么朴素。数据导出/导入JSON 导出用户手动触发生成结构化 JSON 文件{version:1,exportDate:2026-07-12T08:00:00.000Z,accounts:[...],balanceSnapshots:[...],assets:[...],recurringExpenses:[...],maintenanceRecords:[...],valuationHistory:[...],settings:{...}}从 7 个 Repository 各取全量数据打包成一个 JSON。通过expo-sharing调起系统分享面板用户可以发到微信、邮件、云盘。JSON 导入最复杂的部分导入不是简单的把 JSON 写进数据库。核心挑战是ID 重映射清空所有 7 张表逐条插入 accounts记录oldId → newId映射逐条插入 assets同样记录映射插入子表balance_snapshots、recurring_expenses 等用映射表替换外键如果父记录不存在孤儿记录静默跳过整个过程在一个数据库事务内执行。任何一步失败全部回滚。// src/services/import-service.ts (简化)awaitdb.withTransactionAsync(async(){// 清空所有表for(consttableofTABLES){awaitdb.execAsync(DELETE FROM${table});}// 重建账户记录 ID 映射constaccountIdMapnewMapstring,string();for(constaccountofdata.accounts){constnewIdgenerateId();accountIdMap.set(account.id,newId);awaitAccountRepository.create({...account,id:newId});}// 重建子表替换外键for(constsnapshotofdata.balanceSnapshots){constnewAccountIdaccountIdMap.get(snapshot.accountId);if(!newAccountId)continue;// 孤儿记录跳过awaitBalanceSnapshotRepository.create({...snapshot,accountId:newAccountId,});}// ... 其他表类似});CSV 导出给人看的格式方便在 Excel 里查看日期, 微信零钱, 支付宝余额, 招商储蓄卡, ..., 总计 2025-01-15, 3500, 12000, 45000, ..., 60500 2025-02-15, 4000, 11500, 46000, ..., 61500局限性本地优先不是万能的局限说明缓解方案无多端同步换设备需要手动导出/导入JSON 文件 系统分享设备丢失 数据丢失如果没备份自动备份到本地退后台触发图片未备份资产照片存在文件系统中.db备份不包含图片已知问题计划中无加密SQLite 文件可以被直接读取应用锁保护 App 访问总结本地优先架构的核心原则简单胜过完备。不用云同步用文件导出/导入不用后台任务用 AppState 监听不用 ORM用纯 SQL不用复杂加密用应用锁对于一个个人财务 App 来说这些简单方案已经够用了。源码: github.com/callmebg/worthbase | db/ | services/CSDN 标签:SQLiteReact Native数据安全本地存储架构掘金话题:前端数据库React Native架构