HarmonyOS 应用实战 61启动状态别靠默认值猜在页面挂载前水合 currentDeckIdStorageLink(currentDeckId)给一个默认题库 id并不等于真实 Preferences 已经准备好。页面先挂载、存储后水合时首页可能先按默认题库渲染随后又切到用户上次选择抽取入口就会出现闪动或错题库。本文解决四个问题把 currentDeckId 从默认值变成启动事实在页面挂载前完成 Preferences 和 AppStorage 水合页面只消费已校验的当前题库验证冷启动、清数据和删除题库三条路径默认值只能兜底不能代表启动完成默认值适合防止空引用不适合承载业务事实。用户上次选择的题库、默认题库是否存在、题库是否被删除都需要启动阶段读持久化后决定。故障链页面默认 currentDeckIddefault - Preferences 尚未打开 - 用户上次选择未恢复 - 首次抽取走错题库这里要把默认值的角色降下来默认值只负责防止空引用不负责证明用户上次选择已经恢复。页面如果把默认值当事实冷启动第一帧就可能展示错题库。启动快照要包含 currentDeckId 的来源页面不应该猜这个 id 是默认值还是用户选择。启动服务应返回快照明确 id、来源和是否可用。interfaceStartupDeckState{currentDeckId:string;source:stored|default|fallback;available:boolean;reason:string;}启动快照让页面不用猜状态来源。stored、default、fallback三种来源写清楚后页面可以展示当前题库但不会自己重写持久化选择。Bootstrap 在 loadContent 前完成水合最稳的位置是 EntryAbility 或启动编排层先打开 store读取 currentDeckId校验题库存在再写 AppStorage。classStartupStateHydrator{asynchydrate():PromiseStartupDeckState{awaitPreferencesStore.init();conststoredIdawaitAppPreferencesRepository.loadCurrentDeckId();constdeckstoredId?awaitDeckRepository.loadDeck(storedId):null;conststatedeck?{currentDeckId:storedId,source:stored,available:true,reason:恢复上次选择}:{currentDeckId:DEFAULT_DECK_ID,source:fallback,available:true,reason:回退默认题库};AppStorage.setOrCreate(currentDeckId,state.currentDeckId);returnstate;}}水合必须早于首页加载。PreferencesStore.init、题库存在性校验、AppStorage.setOrCreate是一条启动链拆到页面生命周期里就会出现先渲染后纠正的闪动。首页不要在 aboutToAppear 里重写当前题库首页可以读取和展示快照但不应该在挂载时再次决定 currentDeckId。否则启动层和页面层会形成两套规则。Componentstruct HomePage{StorageLink(currentDeckId)privatecurrentDeckId:stringDEFAULT_DECK_ID;Stateprivatesnapshot:HomeSnapshot|nullnull;asyncaboutToAppear():Promisevoid{this.snapshotawaitHomeService.loadSnapshot(this.currentDeckId);}}首页的职责是消费快照不是重新决定当前题库。这样删除题库、升级默认题库、恢复上次选择都由同一个启动 owner 管住。删除题库后的回退也要复用同一规则如果当前题库在上次退出后被删除启动时不能让页面崩溃。Hydrator 和 DeckService.remove 应使用同一套回退策略。classCurrentDeckResolver{asyncresolve(candidateId:string|undefined):Promisestring{if(candidateIdawaitDeckRepository.exists(candidateId)){returncandidateId;}returnDEFAULT_DECK_ID;}}删除题库后的回退规则要复用启动逻辑。否则冷启动走一套 fallback运行中删除又走另一套 fallback用户看到的当前题库会前后不一致。三条启动路径必须单独测清数据首次启动、已有用户选择冷启动、删除当前题库后启动三条路径的预期不同不能只看首页能打开。验证 1. 清数据启动 - currentDeckIdDEFAULT_DECK_ID。 2. 选择自定义题库后重启 - currentDeckId自定义 id。 3. 删除自定义题库后重启 - currentDeckId 回退默认且页面有提示。三条路径要分开测因为它们暴露的是不同风险首次安装看默认播种普通冷启动看持久化恢复删除后启动看回退规则。currentDeckId 排查表如果首页闪一下或抽错题库先查启动水合顺序。现象先看哪里处理首页先默认后切换loadContent 是否早于 hydrate水合后再加载页面抽取走错题库页面是否重写 id统一 CurrentDeckResolver删除后崩溃回退是否在服务层回退默认题库并通知页面排查时先看currentDeckId的来源而不是先改首页 UI。能定位来源就能判断是水合晚了、题库缺了还是页面误写了状态。把启动结论写进水合证据currentDeckId的问题不能只靠肉眼看首页是否显示正确。交付记录应写清楚三件事水合发生在loadContent前当前 id 的来源是什么题库不存在时回退到哪里。路径预期来源证据首次安装default默认题库播种日志首页显示默认题库普通冷启动storedPreferences 中的上次选择被恢复删除后重启fallback已删除 id 不再进入 AppStorage这三条路径要分开写。首次安装成功不能证明用户选择能恢复普通冷启动成功也不能证明删除后的旧 id 会被清理。页面层只允许读不允许抢写 currentDeckId高质量的启动文章要给读者一个可执行边界页面可以读当前题库可以请求切换题库但不能在aboutToAppear里发现空值后直接写默认值。写默认值看似修复了页面实际会覆盖用户上次选择。代码审查重点 1. 搜索 AppStorage.setOrCreate(currentDeckId)确认只出现在启动水合和服务层切换。 2. 搜索 StorageLink(currentDeckId)确认 Builder 里没有对未就绪值直接拼接或取 length。 3. 搜索 loadCurrentDeckId确认读取后会校验题库是否存在。如果项目没有这些证据只能说“设计了水合方案”不能说启动状态已经稳定。失败时按时间线排查启动状态错乱要按时间线查不要先改布局。先看 store 何时 ready再看 seed 何时跑再看currentDeckId何时写入AppStorage最后才看页面如何消费。现象时间线上的断点修复首页先显示默认题库再切换页面早于水合挂载loadContent前完成 hydrate删除题库后仍显示旧名称回退未写入最终事实复用启动回退规则并保存清数据后白屏默认题库未播种或 AppStorage 未设默认seed 与 setOrCreate 放入启动链这篇文章的验证边界是本地启动链设计和静态检查。没有实际运行 HAP 或真机冷启动记录时不要把它写成设备级验证结论。复盘记录要写出状态覆盖关系currentDeckId的复盘记录建议写成覆盖关系而不是只写“已水合”。一次合格记录至少包含旧值、候选题库、最终值和写入位置storedIddeck_old_01 deckExistsfalse fallbackCandidates[deck_default, deck_work] nextCurrentDeckIddeck_default writeBackPreferences.currentDeckId AppStorage.currentDeckId pageConsumesHomePage, DeckSelector, DrawingPage这个记录能说明旧 id 为什么不能继续用也能说明回退不是只改了首页。后续如果用户反馈“重启后又变回已删除题库”团队就能直接检查writeBack是否漏了 Preferences如果只是当前页面正确、重启错误问题就不在 UI而在最终事实没有落盘。小结currentDeckId 是启动事实不是页面默认值。把 Preferences 打开、id 校验、AppStorage 写入放在页面挂载前首页就能消费稳定状态冷启动和删除回退也能走同一套规则。