HarmonyOS 鸿蒙Next中preferences为什么获取不到值，得到是undefined

问题分析

1. 初始化未完成：您的代码中StoreUtil.init()是异步操作（使用preferences.getPreferences的Promise版本），但在put和get方法中调用init()时没有使用await等待初始化完成。这可能导致在Preferences实例尚未初始化时就执行了存储或获取操作，从而获取到undefined。
2. get方法未返回值：您的StoreUtil.get()方法内部调用了dataPreference?.getSync(key, 'default')，但没有使用return语句返回结果。这导致方法返回一个解析为undefined的Promise，因此您在首页调用时得到undefined。
3. 上下文（Context）可能不正确：您使用const context = getContext(this) as common.UIAbilityContext获取context，但在全局或非UIAbility环境中，this可能无法正确指向UIAbilityContext。这会导致Preferences实例创建失败，存储和获取操作无效。
4. 存储操作可能失败：您的put方法使用了putSync和flushSync，但没有错误处理。如果存储过程中发生错误（如键名无效或存储失败），数据可能未被正确写入，导致获取时返回默认值或undefined。

解决方案

1. 确保初始化完成

• 修改init方法，确保返回Promise，并在put和get中等待初始化完成。
• 使用单例模式，避免多次初始化。

2. 修正get方法返回值

• 在get方法中返回getSync的结果，以便调用方可以获取到值。

3. 确保Context正确

• 在UIAbility中获取context并全局保存，或在StoreUtil中传递context参数。避免在全局作用域中使用getContext(this)，因为this可能未定义。

4. 添加错误处理

• 在存储和获取操作中添加异常捕获，打印错误日志以便调试。

修改后的代码示例

import { preferences } from "@kit.ArkData";
import { common } from '@kit.AbilityKit';
import { BusinessError } from "@kit.BasicServicesKit";

// 全局保存context，需在UIAbility中设置
let globalContext: common.UIAbilityContext | null = null;

// 设置全局context的函数（在UIAbility的onCreate中调用）
export function setGlobalContext(context: common.UIAbilityContext) {
  globalContext = context;
}

let dataPreference: preferences.Preferences | null = null;

export class StoreUtil {
  public static async init(): Promise<void> {
    if (!globalContext) {
      console.error("Context is not set. Please call setGlobalContext first.");
      return;
    }
    try {
      dataPreference = await preferences.getPreferences(globalContext, 'userStore');
      console.info('Succeeded in getting preferences.');
    } catch (e) {
      console.error('Failed to get preferences. Error: ' + e);
    }
  }

  public static async put(key: string, value: preferences.ValueType): Promise<void> {
    if (!dataPreference) {
      await StoreUtil.init();
    }
    if (!dataPreference) {
      console.error("Preferences instance is null.");
      return;
    }
    try {
      dataPreference.putSync(key, value);
      dataPreference.flushSync();
      console.info("Succeeded in putting value.");
    } catch (e) {
      console.error("Failed to put value. Error: " + e);
    }
  }

  public static async get(key: string, defaultValue: preferences.ValueType = 'default'): Promise<preferences.ValueType> {
    if (!dataPreference) {
      await StoreUtil.init();
    }
    if (!dataPreference) {
      console.error("Preferences instance is null.");
      return defaultValue;
    }
    try {
      return dataPreference.getSync(key, defaultValue);
    } catch (e) {
      console.error("Failed to get value. Error: " + e);
      return defaultValue;
    }
  }

  public static async delete(key: string): Promise<void> {
    if (!dataPreference) {
      await StoreUtil.init();
    }
    if (!dataPreference) {
      console.error("Preferences instance is null.");
      return;
    }
    try {
      dataPreference.deleteSync(key);
      dataPreference.flushSync();
      console.info("Succeeded in deleting value.");
    } catch (e) {
      console.error("Failed to delete value. Error: " + e);
    }
  }
}

在UIAbility中设置全局Context

在您的UIAbility（例如EntryAbility）中，设置全局context：

import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { setGlobalContext } from '../utils/StoreUtil'; // 调整路径

class EntryAbility extends UIAbility {
  onCreate() {
    setGlobalContext(this.context);
    // 可选：初始化StoreUtil
    StoreUtil.init().then(() => {
      console.info('StoreUtil initialized.');
    });
  }
}

在首页调用

在页面中，确保在操作前等待初始化完成，然后使用async/await或Promise方式调用：

// 存储数据
StoreUtil.put('userdata', '1231231').then(() => {
  console.info('Storage successful.');
});

// 获取数据
StoreUtil.get('userdata').then((res) => {
  console.info('Value from preferences: ' + res);
});

注意事项

• 同步与异步：您的代码混合了同步和异步方法。如果使用同步方法（如getSync），请确保Preferences实例已初始化。建议统一使用异步方式以避免竞态条件。