★ FEATURED ARTICLE 做信息流类App十个有九个死在数据读取体验上。用户打开了你的今日资讯App冷启动那几秒如果永远都是空白页转圈他大概率等不到第一篇资讯加载出来就划走了。前25篇我们把这个系列从Flutter环境搭建一直推进到了网络层、状态层和UI层现在坑已经挖到了最关键的一步本地存储实现。这一篇不是简单聊“怎么用shared_preferences存个字符串”而是要从资讯类App的真实需求出发把键值存储、结构化缓存、文件缓存和缓存淘汰策略一次讲透。为什么要单开一篇说本地存储因为资讯App的信息流天然具备“重读”属性用户早晚会滑回到已经看过的内容或者在没有信号的电梯里尝试打开App。如果没有本地存储这层兜底网络抖动、服务端压力、用户耐心任何一个环节都能把体验打穿。本篇围绕Flutter for OpenHarmony 本地存储实现展开适合正在用Flutter做OpenHarmony应用、尤其是内容型应用的开发者阅读我会把需要映射的API差异、需要绕开的坑以及可直接落地的缓存设计全部讲清楚。1. 资讯App的数据持久化需求拆解先弄清楚到底要存什么很多开发者在做本地存储时犯的第一个错误是“为了存储而存储”上来就把整个资讯列表塞进数据库结果列表页加载速度没提上去反而因为反序列化开销把主线程卡成了PPT。在设计阶段先搞清楚业务数据的分层归属比研究存储API更重要。1.1 新闻生产与消费链路中哪些数据值得落盘我把资讯App里的数据分成四类每一类的持久化诉求完全不同用户偏好设置。包括主题模式日间/夜间、字体大小、所在城市、消息推送开关。这类数据的特点是体积小、读取频率极高、几乎不变化但一旦丢失用户会明显感觉“App不记得我了”。适合用键值存储毫秒级读写且写入次数极低性能压力可以忽略。资讯内容本身。包括文章标题、摘要、封面图URL、发布时间、正文内容等。这是数据量最大、更新频率最高的一类。但请注意资讯内容的实时性决定了我们永远不能只读缓存缓存只能是“网络失败时的兜底”和“二次浏览时的加速通道”。用户行为数据。包括阅读历史、收藏列表、点赞记录、搜索关键词。这类数据是用户主动产生的必须持久化且要保证不丢失。以收藏为例用户收藏了一篇文章如果换一台设备或重启App后收藏没了这种信任损失是无法修复的。元数据与运行状态。比如上次缓存刷新时间、本地数据库版本号、已读文章ID集合。这类数据一般是开发者为自身业务逻辑服务的例如通过“缓存时间戳”来判断缓存是否过期、是否需要重新请求网络。你会发现如果把这四类数据全部用同一种存储方案去承载设计上一定会有别扭的地方。偏好设置用数据库存太重用资讯正文全部放键值存储内存和序列化开销又吃不消。合理的设计是按需分层每类数据选择最适合的存储介质。1.2 OpenHarmony资讯场景下Flash Memory损耗与性能的平衡这里要多说一个OpenHarmony设备尤其是IoT设备和轻量级智能终端的特殊背景很多目标设备的Flash存储芯片并不具备手机级别的读写寿命和性能频繁的瞬时写入会加速Flash磨损。所以在设计落盘策略时我在这个系列里前25篇反复强调过一个原则能延时写入就不要即时写入能合并写入就不要拆分写入。宁愿让“设置项”的保存动作在用户停止连续操作后统一落盘也不要每改一个字号滑块就触发一次持久化调用。还有一点容易被忽略如果某个资讯App在OpenHarmony设备上后台运行系统会限制它的IO资源调度这时候如果App还在盲目地写数据库不仅写入速度会变得极慢还可能因为IO占满被系统判定为异常进程。所以本地存储架构里的“线程模型”必须提前设计好——落盘任务全部丢进后台IsolateUI线程永远不等待磁盘IO完成。2. Flutter存储方案对比OpenHarmony适配下没有银弹但有一条最稳的路Flutter官方提供了丰富的存储生态但迁移到OpenHarmony后很多插件并不天然可用。我先说结论再逐项展开对比。存储需求推荐方案OpenHarmony适配难度适用场景轻量键值对shared_preferences低有社区适配方案用户偏好、开关状态、最小缓存结构化较多数据轻量数据库中需要FFI包装或原生接入资讯列表缓存、收藏、阅读历史大文件path_provider 手写文件IO低但有路径映射问题图片缓存、整篇离线缓存容量大且需要强一致原生数据库如关系型数据库高需自研通道暂不推荐除非业务强依赖2.1 shared_preferences键值存储的第一选择但别让它承担太多shared_preferences在OpenHarmony上可以通过社区适配插件来使用底层映射的是系统的持久化偏好存储能力。这个方案的优势是API简单、接入成本极低、读取走缓存内存中保留全量副本。但有两个限制一是不适合存大对象。如果你把一个100KB的JSON字符串塞进SharedPreferences每次读取都会做全量反序列化且所有读操作都会持有同一个锁一旦数据膨胀其他键的读取也会被拖慢。二是写入不保证原子性。虽然单条写入是同步的但如果你在一个事务里连续改10个key任何一步崩溃都可能导致数据不一致。所以我的策略是shared_preferences只存两类东西一是全局业务状态登录态、省份ID、缓存开关二是“瞬时状态快照”比如App上次退到后台时正在浏览的资讯列表位置。2.2 数据库方案OpenHarmony上的sqflite适配以及不为人知的FFI坑对于资讯列表缓存、收藏列表这类结构化数据我倾向于使用轻量数据库。开发过Flutter的同学对sqflite并不陌生但当你把它跑到OpenHarmony上会遇到一个经典问题sqflite插件底层依赖的是Android/iOS的系统数据库APIOpenHarmony上并不能像在Android上那样直接拿到系统SQLite的通道。此时有两类路线路线一使用sqflite_common_ffi。它把SQLite的C接口通过dart:ffi暴露出来算是在Flutter层把数据库引擎内嵌了不依赖系统原生API。这个方案在OpenHarmony上相对可行因为FFI机制在OpenHarmony上是有完整支持的。我实测下来正常读写没有问题依赖库体积会增大一些但在资讯App场景下完全可以接受。路线二寻找OpenHarmony原生的数据库适配插件。有一些厂商在维护适配层但成熟度参差不齐API风格也可能和标准sqflite不一样直接接入手感和踩坑成本都不小。最终在这个系列里我选了路线一也就是sqflite_common_ffi。理由很简单API 95%兼容sqflite社区案例足够多将来即便要换方案业务代码的迁移成本也是最小的。2.3 文件存储图片缓存必须走文件系统而不是数据库BLOB很多新手会犯一个错误把图片的Base64字符串存进数据库。这在数据量小的时候好像没什么问题等图片多起来数据库体积直奔几百MB查询和备份都会变成灾难。正确做法是图片文件落在文件系统数据库或键值存储里只保存文件路径和元信息。用path_provider这样的插件拿到缓存目录按URL的哈希做文件目录分片再把“文件路径-网络URL”的映射关系存进键值存储。这样不仅读取快清理过期图片时只需要扫文件目录完全不需要碰数据库。3. 键值存储落地实战从依赖引入到业务封装方案定了下面直接进入代码。我不会把完整代码贴满全文而是摘出每个阶段的骨架和关键设计思路帮助你“直接抄作业”的同时还能理解为什么这样写。3.1 依赖版本与初始化用一个单例包住存储操作在pubspec.yaml中引入依赖dependencies: flutter: sdk: flutter shared_preferences: ^2.2.2 sqflite_common_ffi: ^2.3.0 path_provider: ^2.1.2 path: ^1.8.3关于sqflite_common_ffi有一个需要特别注意的点必须在初始化数据库之前调用一次sqfliteFfiInit()。把这句话放在App启动时的main函数里否则后续的数据库打开操作会在Android以外的平台上找不到原生SQLite引擎。import package:sqflite_common_ffi/sqflite_ffi.dart; void main() { // 初始化FFI数据库引擎OpenHarmony上必须Android原生环境可省略但加了也无副作用 sqfliteFfiInit(); runApp(const TodayNewsApp()); }3.2 封装SettingService把业务键和存储细节隔离直接在各业务页面里调用SharedPreferences.getInstance()不是不行但一旦有新增键、缓存策略变化、或者未来要换成其他存储方案你会面临代码里到处散落存储调用的窘境。我更建议用一个单例Service将所有键的管理集中起来。class SettingService { SettingService._(); static final SettingService instance SettingService._(); static const _keyThemeMode settings_theme_mode; static const _keyFontScale settings_font_scale; static const _keyProvinceCode settings_province_code; static const _keyLastSyncTime settings_last_sync_ms; FutureString getProvinceCode() async { final prefs await SharedPreferences.getInstance(); return prefs.getString(_keyProvinceCode) ?? 00; } Futurevoid setProvinceCode(String code) async { final prefs await SharedPreferences.getInstance(); await prefs.setString(_keyProvinceCode, code); // 省份切换后资讯缓存全部失效这里顺手清除或者由上层统一处理 } Futureint getLastSyncTimeMs() async { final prefs await SharedPreferences.getInstance(); return prefs.getInt(_keyLastSyncTime) ?? 0; } Futurevoid updateLastSyncTimeMs() async { final prefs await SharedPreferences.getInstance(); await prefs.setInt(_keyLastSyncTime, DateTime.now().millisecondsSinceEpoch); } }把读取和写入封装成语义化方法之后业务层完全无需关心底层是SharedPreferences还是Future存取。将来如果OpenHarmony上出现了性能更好的原生键值存储只需要改动这个Service内部实现调用方一行代码都不用动。3.3 防抖写入与恢复策略记住“频繁更新只会更快磨损Flash”刚才提到设备Flash寿命问题在键值存储上体现得最明显。以字体大小为例如果用户把系统字体调大UI会跟着变化每次滑块滑动都触发一次prefs.setDouble()一分钟可能写入几十次这既不必要也对存储介质不友好。我建议在SettingService内部做一个极简防抖每次set操作都把值先写入内存缓存同时启动一个5秒的定时器如果5秒内没有新的set调用才真正执行一次偏好存储的持久化。这里需要强调内存中的值必须及时生效因为UI读取的是当前值而持久化可以延后。那如果App在防抖窗口内被杀掉了怎么办只要不是改字体这种“下次打开还能再调”的设置确实存在丢失风险。所以我把“即时持久化”和“延后持久化”策略分开使用关键业务数据收藏、用户行为记录立即落库偏好设置主题色、字号用防抖合并落盘。4. 结构化存储落地一张资讯表、一张收藏表解决核心业务缓存资讯列表缓存和用户收藏是数据库层最重要的两张表。我来拆解建表逻辑、读写路径以及为什么这么设计能兼顾性能和一致性。4.1 建表语句与索引设计避免全网最经典的“全表扫描”悲剧我在前几篇系列文章中提到过OpenHarmony设备的内存和CPU资源并不算充裕数据库查询性能必须靠索引撑起来。以下是两张核心表的设计CREATE TABLE IF NOT EXISTS news_cache ( id INTEGER PRIMARY KEY AUTOINCREMENT, news_id TEXT NOT NULL, category_code TEXT NOT NULL, title TEXT NOT NULL, summary TEXT, cover_url TEXT, content TEXT, publish_time INTEGER NOT NULL, cached_time INTEGER NOT NULL, is_read INTEGER DEFAULT 0 ); CREATE INDEX idx_news_category_time ON news_cache(category_code, publish_time DESC); CREATE TABLE IF NOT EXISTS user_favorites ( id INTEGER PRIMARY KEY AUTOINCREMENT, news_id TEXT NOT NULL UNIQUE, title TEXT NOT NULL, cover_url TEXT, added_time INTEGER NOT NULL );这里的两个关键设计点一是news_cache表里我只存“摘要”和“正文”的原始文本不存序列化的复杂结构体。如果某个字段在后续版本里要迁移、要加列结构变化的影响面会小很多。二是索引的顺序不能乱。(category_code, publish_time DESC)这个联合索引能同时支撑“按分类查最新资讯”和“按时间范围清理过期缓存”两类高频查询。如果你单独给category_code建索引又给publish_time建索引每次查询时数据库可能不得不走回表性能远不如联合索引。4.2 DAO层的读写封装每个操作都要走预设通道不建议在业务代码里直接拼SQL。我封装了NewsCacheDao和FavoriteDao对外只暴露语义明确的读取和写入方法class NewsCacheDao { final Database db; NewsCacheDao(this.db); FutureListNewsCacheItem getLatestNews(String categoryCode, int limit) async { final rows await db.query( news_cache, where: category_code ?, whereArgs: [categoryCode], orderBy: publish_time DESC, limit: limit, ); return rows.map(NewsCacheItem.fromMap).toList(); } Futurevoid batchInsert(ListNewsCacheItem items) async { final batch db.batch(); for (final item in items) { batch.insert(news_cache, item.toMap(), conflictAlgorithm: ConflictAlgorithm.replace); } await batch.commit(noResult: true); } }这里要特别解释一下batchInsert的设计意图。如果你逐条执行INSERT10条资讯就要发起10次数据库事务在低端设备上可能要几十毫秒才能完成。而用Batch把所有写入放在一个事务里不仅耗时大幅缩短还能保证“要么全部写入成功要么全部不写”不会出现列表缓存半新半旧的脏状态。4.3 缓存一致性千万不要让“已读状态”污染了资讯缓存藏了一个很容易被忽略的坑资讯列表内容本身是公共的而“是否已读”是每个用户私有的行为数据。在实际开发中我发现把is_read字段直接放进news_cache表看似方便但会导致一个严重问题当同一篇资讯因为内容更新被重新拉取覆盖时用户原本的“已读”状态会随着缓存行的替换一起消失。更好的设计是拆成两张表news_cache只管内容news_read_status记录阅读状态。当然为了简单起见如果列表缓存只是短期兜底放在同一张表也能接受。这个取舍取决于你的产品语义如果用户非常看重“哪些文章我点过了”的标记后续数据表拆分的成本很高不如一开始就把已读状态独立出来。5. 文件缓存与离线策略图片和整篇资讯到底怎么落盘接下来聊最容易失控的部分图片缓存和离线阅读。这里不搞复杂的第三方图片缓存库而是基于文件系统和键值存储做一个自研的极简方案目的是在OpenHarmony上保持高度可控。5.1 缓存目录规划给不同类型的文件设定独立的生存周期path_provider在OpenHarmony上能拿到应用缓存目录但注意不要把所有文件都堆在一个目录里。我建议按功能拆分同时给不同目录设置不同的“生存周期”策略cache_root/ ├── covers/ # 资讯封面图LRU淘汰保留最近30天 ├── content_html/ # 离线正文有效期7天 └── temp/ # 临时文件例如下载的压缩包用后即删为什么要分开目录因为清理策略简单了很多。比如系统存储空间吃紧时只需要递归删除temp和covers里“过期”的文件根本不会误删用户主动收藏的离线内容。5.2 图片URL映射文件路径用哈希做键而不是直接拼文件名图片缓存最怕的是URL里的参数千奇百怪有的带时间戳、有的带签名、有的带中文转义。如果直接用URL做文件名你早晚会遇到“路径过长”“非法字符”等问题。我的做法是取URL的有效部分做MD5摘要再以摘要的前两个字符作为层目录名。这样可以把文件分布到多级目录下避免单个目录文件过多导致文件系统性能下降。String filePathForUrl(String url, String rootDir) { final hash _md5(url); final dir ${rootDir}/${hash.substring(0, 2)}; Directory(dir).createSync(recursive: true); return $dir/${hash.substring(2)}.img; }当然全局需要维护一个url - filePath的映射。这个映射放进shared_preferences即可数据量不大且每次写入频率不高。5.3 离线读取优先级内存 - 磁盘文件 - 网络顺序一定不能乱资讯详情页的加载路径我建议这样设计先从内存缓存里查命中就直接渲染耗时约0ms。内存未命中则检查本地数据库或文件缓存命中后渲染数据同时异步启动网络刷新来更新本地缓存。本地也没有才展示loading发起网络请求。这个顺序的核心思想是“让用户先看到内容再在背后更新”。尤其在弱网环境下如果用户在电梯里打开了一篇之前已经缓存过的文章整个过程应该感觉不到任何网络参与。有一点要提醒网络请求的结果回来之后不要直接强制刷新UI。如果用户已经看到旧版本内容且正在阅读突然整个页面被替换体验会非常糟糕。应该做一次“内容版本对比”只有当数据确实发生变化比如发布时间不同时才给出刷新提示。6. 踩坑实录OpenHarmony特有的本地存储问题与修复过程写到最后一个章节我把自己在这个系列开发中踩过且印象深刻的坑集中捞出来聊一遍。这些坑都不是看文档能直接发现的基本靠日志和时间堆出来的。6.1 数据库文件路径在OpenHarmony上拿不到先确认目录是否存在在OpenHarmony上使用path_provider时我遇到过getApplicationDocumentsDirectory()返回的路径指向一个尚未创建的目录而sqflite_common_ffi在打开数据库文件时不会自动递归创建父目录。第一次启动时数据库初始化必定失败报错信息又不够直观很容易让人误判为插件本身不兼容。解决方式也很简单在初始化时手动创建目录final docsDir await getApplicationDocumentsDirectory(); final dbDir Directory(${docsDir.path}/app_data); if (!dbDir.existsSync()) { dbDir.createSync(recursive: true); } final dbPath join(dbDir.path, news_cache.db);这类问题在于Android上默认的目录已经存在所以代码不写创建也不会报错。一旦跨到OpenHarmony这些小差异就全部暴露出来。建议将目录兜底创建作为一个通用函数放到所有平台初始化流程里而不是只为了OpenHarmony单独加。6.2 异步事务并发导致锁死所有数据库操作必须串行化我一开始在资讯列表下拉刷新时同时启用了“批量插入新数据”和“删除过期数据”两个独立的异步事务。表面上看起来没问题但OpenHarmony低端设备上SQLite的锁竞争频繁出现偶尔直接抛出“database is locked”。后来检查发现多个并发操作不来自同一个数据库实例还好一旦来自不同的async上下文对数据库写锁的获取顺序不可控死锁概率大增。我的整改方案是为所有数据库操作引入一个全局写队列保证同一时间只有一条写操作在执行。final _writeQueue QueueFuturevoid Function()(); FutureT _enqueueWriteT(FutureT Function() task) { final completer CompleterT(); _writeQueue.add(() async { try { final result await task(); completer.complete(result); } catch (e) { completer.completeError(e); } }); return completer.future; }读写分离未必适合所有场景但在资讯类App里读多写少且写操作集中于刷新和收藏动作用串行化换取稳定性是完全值得的。6.3 热重载后SharedPreferences的脏读问题注意动态更新Key这个坑在我看来最隐蔽。在OpenHarmony上进行Flutter热重载Hot Reload开发调试时我多次遇到SharedPreferences读到的值不是最新值排查了半天最后发现是热重载直接复用了进程内的SharedPreferences单例而底层持久化文件尚未同步完成时内存缓存依然是旧值。这个问题的本质是Flutter热重载会重新执行main入口代码但不会中止和重建Native层的单例对象。如果你在热重载后立即读取某个刚被修改的存储键拿到的是上一轮进程状态里的缓存。解决方式说起来很简单调试阶段在SharedPreferences写入后手动增加200ms左右的延时再触发读取给底层落盘一个缓冲时间。正式的release构建中由于不会出现“热重载中途切断”的场景这个问题几乎不存在。但它提醒我们存储层的异步穿衣顺序藏在一层薄薄的适配之下开发时就必须有意识地区分“内存态”和“持久态”。6.4 大列表清理策略别在UI线程删除过期列表资讯缓存列表越积越多必须有清理动作。很多开发者会在App的onPause或onStop时调用清理逻辑但是这里的坑藏在“清理动作的线程”里。如果清理逻辑是在主Isolate里同步执行SQL的DELETE当缓存列表有几万行时删除操作会把UI卡出一两秒的白屏。在手机上都让人难受在低配的OpenHarmony设备上基本等于灾难。我的实践是把清理任务放在一个后台Isolate上执行或者至少包装到Future(() {})的Timer任务中让数据库清理永远不碰UI线程。同时清理的粒度按“每次最多删500条”分批执行避免一次大事务占用过久。Futurevoid _cleanExpiredCache() async { final now DateTime.now().millisecondsSinceEpoch; final expireThreshold now - 7 * 24 * 60 * 60 * 1000; await _enqueueWrite(() async { const batchSize 500; while (true) { final deleted await db.delete( news_cache, where: publish_time ? AND cached_time ?, whereArgs: [expireThreshold, expireThreshold], limit: batchSize, ); if (deleted 0) break; } }); }删除结果返回0就说明已经清理干净可以结束循环。如果一次删5000行事务时间虽短但对低端设备而言依然太重。分批删除每次事务小、耗时可预测还能让清理任务在后台队列里让出CPU时间片。结尾这套本地存储方案在这个资讯App项目里跑了两三个月给我最大的体感是OpenHarmony上的Flutter存储开发难点从来不是“不会用某个API”而是所有API都有一层若隐若现的平台差异不亲自跑到真机上永远不知道问题在哪。我建议你拿出真机或模拟器按本文的顺序从SharedPreferences封装开始搭起再逐步把数据库落地最后再接入缓存清理策略——每一层都能独立测试出了问题也好排查。如果后面遇到更换数据库引擎或者存储迁移的场景我会在这个系列里继续更新目前这几张表和这套Service结构应付资讯类App的绝大多数场景已经够用了。
阅读完成 · 觉得有帮助？
