HarmonyOS鸿蒙Next中Preferences存储数据丢失，重启APP后数据为空

HarmonyOS鸿蒙Next中Preferences存储数据丢失，重启APP后数据为空

问题描述

用鸿蒙 @ohos.data.preferences 存储用户登录状态（isLogin: boolean），登录时调用 putBoolean 和 flush，但重启 APP 后调用 getBoolean 返回默认值 false，数据丢失了，怎么解决？关键字：鸿蒙 Preferences、数据丢失、flush、重启 APP

回答内容

原理解析

Preferences 数据丢失的核心原因是 “未正确调用 flush ()”或“存储路径错误”：

• 问题 1：put操作后未调用flush()，数据仅在内存中，未写入磁盘；
• 问题 2：getPreferences时传入的name不一致（如大小写错误、路径错误）；
• 问题 3：应用被强制终止时，flush()未执行完成。

解决步骤

步骤 1：确认flush()是否正确调用put操作后必须调用flush()才能将数据写入磁盘，且需等待flush()完成：

import preferences from '@ohos.data.preferences';
import common from '@ohos.app.ability.common';

// 正确的存储流程
async function saveLoginState(isLogin: boolean) {
  try {
    const context = getContext(this) as common.UIAbilityContext;
    // 1. 获取Preferences实例（name需唯一，建议用应用包名）
    const pref = await preferences.getPreferences(context, 'app_prefs');
    // 2. 存储数据
    await pref.putBoolean('isLogin', isLogin);
    // 3. 必须调用flush()，且等待完成
    await pref.flush();
    console.log('数据存储成功');
  } catch (err) {
    console.error('数据存储失败：', err);
  }
}

步骤 2：确认getPreferences的name一致存储和读取时的name必须完全一致（包括大小写）：

// 读取数据
async function getLoginState() {
  try {
    const context = getContext(this) as common.UIAbilityContext;
    // name必须与存储时一致（这里是'app_prefs'）
    const pref = await preferences.getPreferences(context, 'app_prefs');
    // 第二个参数是默认值
    const isLogin = await pref.getBoolean('isLogin', false);
    return isLogin;
  } catch (err) {
    console.error('数据读取失败：', err);
    return false;
  }
}

**步骤 3：避免在应用退出时强制终止flush()**若在应用退出时调用flush()，需确保有足够时间完成：

// 在UIAbility的onDestroy中保存数据
export default class MainAbility extends UIAbility {
  async onDestroy() {
    try {
      const pref = await preferences.getPreferences(this.context, 'app_prefs');
      await pref.flush();
      console.log('应用退出时数据保存成功');
    } catch (err) {
      console.error('应用退出时数据保存失败：', err);
    }
  }
}

步骤 4：检查存储路径是否正确Preferences 默认存储在应用沙箱的/data/app/ohos/<包名>/preferences目录下，可通过以下代码查看：

async function getPrefPath() {
  const context = getContext(this) as common.UIAbilityContext;
  const pref = await preferences.getPreferences(context, 'app_prefs');
  console.log('Preferences存储路径：', pref.getPreferencesPath());
}

若路径中包含中文或特殊字符，可能导致存储失败，建议name用英文 + 数字。

**步骤 5：兜底方案（改用 RelationalStore）**若 Preferences 仍不稳定，改用鸿蒙的关系型数据库RelationalStore（更适合需要持久化的数据）：

import relationalStore from '@ohos.data.relationalStore';

// 初始化数据库
async function initDb() {
  const context = getContext(this) as common.UIAbilityContext;
  const store = await relationalStore.getRdbStore(context, {
    name: 'app_db.db',
    securityLevel: relationalStore.SecurityLevel.S1
  });
  // 创建表
  await store.executeSql('CREATE TABLE IF NOT EXISTS user (id INTEGER PRIMARY KEY, isLogin BOOLEAN)');
  return store;
}

// 存储数据
async function saveLoginState(isLogin: boolean) {
  const store = await initDb();
  const valuesBucket = { isLogin: isLogin };
  await store.insert('user', valuesBucket);
}

// 读取数据
async function getLoginState() {
  const store = await initDb();
  const result = await store.query('SELECT isLogin FROM user LIMIT 1', []);
  let isLogin = false;
  if (result.goToFirstRow()) {
    isLogin = result.getBoolean(result.getColumnIndex('isLogin'));
  }
  result.close();
  return isLogin;
}

避坑提醒

• 不要在主线程中执行大量put和flush操作：会阻塞 UI，建议用异步函数；
• 避免存储过大的数据：Preferences 适合存储小数据（如配置、状态），大数据用File或RelationalStore；
• 测试时用真机：模拟器的沙箱存储可能不稳定。