把鸿蒙 Preferences 当小型数据库用:串行队列防竞态,写失败要回滚缓存

举报
yd_241537561 发表于 2026/11/17 07:04:47 2026/11/17
【摘要】 一组自定义任务存进鸿蒙 Preferences,真正的坑不在 get/put,在并发读改写和写一半失败:flush 抛错时内存缓存可能已被 put 改掉。AdventureWheel 案例用一条 Promise 串行队列,加「失败暂存原值、下次读取时恢复」,把两件事都堵住了。

鸿蒙的 preferences 是键值存储,官方定位是「轻量配置」。但需求稍一上头——比如一个可增删改的自定义任务列表——就会有人把整表 JSON 序列化后塞进一个 key。这么做完全可行,AdventureWheel 案例就是这么干的,但它的 LocalTaskStore.ets 值得逐段读:所有读改写都串行排队,写失败还要把内存缓存回滚到写之前。这两段代码是整份案例里含金量最高的部分。

一、为什么读改写会竞态

键值库里存列表,增删改的每一步都是「读全量 → 改 → 写回」。两个操作并发时,后写的一方会把自己读到的旧快照写回去,先写的修改直接蒸发。对配置项(写一次读多次)无所谓,对列表(每次界面操作都写)迟早出事。案例的解法是给整个 store 套一条 Promise 链,任何操作都排队执行:

export class LocalTaskStore {
  private static store: preferences.Preferences | null = null;
  private static operationQueue: Promise<void> = Promise.resolve();
  private static restoreRaw: string | null = null;

  private static enqueue<T>(operation: () => Promise<T>): Promise<T> {
    const result = LocalTaskStore.operationQueue.then(operation);
    // 队尾只负责继续调度;原始 result 的拒绝仍交给调用者处理。
    LocalTaskStore.operationQueue = result.then((): void => {}, (): void => {});
    return result;
  }
}

五行代码有两个容易写错的点。第一,operationQueue 接的是 result.then(no-op, no-op),把错误吞掉只续链——如果直接把 result 接上去,任何一个操作的失败会让链永久停在 rejected 状态,之后所有操作都不再执行。第二,返回给调用方的是原始 result,错误照常抛给界面层,排队和报错互不干扰。

二、写失败的回滚:put 成功不等于安全

Preferences 的 put 只改内存缓存,flush 才落盘。如果 flush 抛错(磁盘满、文件被锁),内存缓存里已经是新值了——下一次读改写读到的就是这份「没有真正落盘的脏状态」,在脏状态上继续改,数据就开始飘。案例在每次 save 前先记下旧值,flush 失败就把旧值暂存起来,等下一次读取时恢复:

private static async save(tasks: LocalTaskRecord[]): Promise<void> {
  const store = LocalTaskStore.requireStore();
  const previousRaw = await store.get(TASKS_KEY, '[]') as string;
  try {
    await store.put(TASKS_KEY, JSON.stringify(tasks));
    await store.flush();
  } catch (error) {
    // put 可能已更新 Preferences 缓存;恢复原值后才允许下一次读改写。
    LocalTaskStore.restoreRaw = previousRaw;
    try {
      await LocalTaskStore.restoreIfNeeded(store);
    } catch (restoreError) {
      console.error('LocalTaskStore: 原值待恢复,下次读取时重试');
    }
    throw new Error('本地任务写入失败,请重试');
  }
}

private static async restoreIfNeeded(store: preferences.Preferences): Promise<void> {
  const raw = LocalTaskStore.restoreRaw;
  if (raw !== null) {
    await store.put(TASKS_KEY, raw);
    await store.flush();
    LocalTaskStore.restoreRaw = null;
  }
}

恢复这一步也可能失败(磁盘还是满的),所以它不在失败路径里死磕,而是留一个待恢复标记,每次 read() 开头先 restoreIfNeeded——等磁盘恢复可用,第一笔读操作顺手把状态修回来。这个「延迟重试」的结构比在 catch 里递归重试干净得多。

三、查重靠 normalize,别信原文比对

任务列表要挡重复录入,但用户眼里的「一样」和字符串相等不一样:多敲一个空格、大小写不同,语义上还是同一条。案例的做法是把文本归一化后比对:

private static normalize(text: string): string {
  return text.trim().toLowerCase().replace(/\s+/g, '');
}

private static ensureUnique(tasks: LocalTaskRecord[], type: TaskType, text: string, excludeId: string = ''): void {
  const normalized = LocalTaskStore.normalize(text);
  if (tasks.some((item: LocalTaskRecord) => item.id !== excludeId && item.type === type &&
    LocalTaskStore.normalize(item.text) === normalized)) {
    throw new Error('同类型中已经有相同任务');
  }
}

编辑场景记得传 excludeId——不改文本只改别的字段时,记录会跟自己「重复」。导入合并(mergeImported)走同一套 normalize,重复的跳过并统计新增条数返回,界面才能提示「导入 12 条,新增 8 条」。

四、配置类存储:每次写完立刻 flush

同一个案例里的 PreferenceStore 管「上局模式、任务数、风险档、音效开关、免责声明」这类配置,走的是另一个极端:每次 put 完立刻 flush,读失败就回默认值:

private static async put(key: string, value: preferences.ValueType): Promise<void> {
  try {
    await PreferenceStore.store?.put(key, value);
    await PreferenceStore.store?.flush();
  } catch (error) {
    console.error('PreferenceStore: 写入失败');
    throw new Error('偏好设置写入失败');
  }
}

配置的量小、丢一条不心疼,立刻 flush 换的是「下次启动一定读到」;列表的量大、一次全量写回,才值得上队列和回滚。两套并存正好说明:存储方案没有高低,看数据形态选纪律。

五、什么时候该换关系型数据库

Preferences 当列表数据库的上限,大概在几十条、单 key 全量读写、无查询条件的场景。再往上——要按字段查询、要分页、要做数据迁移——就该换关系型数据库(RDB)或者官方的对象关系映射库。判断信号也简单:当你开始在 JSON 字符串里手写版本号(案例里就埋了 custom_tasks_v1)准备将来自己写迁移代码时,说明这份数据已经配得上一个真正的库了。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。