程序崩了别慌！鸿蒙应用开发中的错误处理全攻略

在鸿蒙开发圈混久了，我常开玩笑说："写代码是艺术，调 Bug 是修行，错误处理是人品。"

写鸿蒙应用时，咱们追求的从来不只是“跑起来”，而是要能“跑得稳、出错不慌、用户不崩溃”。
你想啊，用户轻轻一点，App就白屏、闪退、甚至数据丢失，这谁顶得住？这时候，错误处理和恢复机制就成了真正的“救命稻草”。

今天咱们就来聊聊鸿蒙应用开发中的错误处理思路与实战技巧，顺带我也分享几个“踩坑血泪史”，别让你也走一遍我的弯路。

一、错误不可怕，怕的是你没准备好

先说一个真事：

有次我在开发一个鸿蒙的日程提醒 App，逻辑大概是：读取数据库中的任务 → 展示 → 点击可标记为完成。测试时一切正常，结果上线三天后，用户反馈“App打开直接黑屏”。

问题根源是：数据库字段新增但没做兼容处理，导致某个 JSON 字段解析异常，应用直接挂掉。

这一类“数据不兼容导致的奔溃”，说实话不复杂，但如果我们没有兜底机制，对用户来说就只有一个词：灾难。

二、鸿蒙应用中错误处理的关键节点

我们来看鸿蒙应用开发（尤其是使用 ArkTS 时）在哪些地方最容易出问题，以及怎么“兜住”。

1. 页面级逻辑错误

比如你在 onPageShow() 里调用了接口，然后 JSON 解析失败、或者 Promise.reject，没有 try-catch，很可能直接引发白屏。

@Entry
@Component
struct MainPage {
  @State message: string = "Loading...";

  async aboutToAppear() {
    try {
      let res = await fetchDataFromServer(); // 异常点
      this.message = res.data.message;
    } catch (err) {
      console.error('拉取数据失败:', err);
      this.message = "数据加载失败，请稍后再试";
    }
  }
}

建议：

• 所有异步调用必须配合 try-catch
• 可以统一封装 API 调用接口，加上 fallback 机制

2. 组件异常：UI 崩坏的“幕后黑手”

组件异常很多时候是因为传参错误或未初始化就使用变量。举个栗子：

@Component
struct UserInfo {
  @Prop user: User;

  build() {
    Text(this.user.name) // user 可能为 undefined
  }
}

防御式写法建议如下：

Text(this.user?.name ?? "访客")

咱得学会对“数据异常”做默认容错，不要盲目相信 props/state 肯定有值。

3. 全局异常捕捉：最后的“护城河”

鸿蒙支持通过 globalThis 捕捉运行时异常，我们可以加一个全局兜底机制：

globalThis.onunhandledrejection = (reason) => {
  console.error("未捕获 Promise 异常", reason);
  // 上报日志 or 弹窗提示
};

这相当于给程序套上“保险带”，不至于因一处未 catch 而整体崩盘。

三、恢复机制：别只想着报错，还要想怎么救回来

错误处理不是终点，恢复机制才是体验感分水岭。

✅ 比如：网络异常

别一失败就 return，你可以提示重试、离线缓存、甚至降级展示。

catch (err) {
  this.message = "网络异常，显示本地缓存数据";
  this.message = getCachedData(); // 缓存兜底
}

✅ 比如：登录状态失效

用户 token 失效时，跳转登录页、清除会话、记住之前位置，回登录后还能自动回跳。

if (res.code === 401) {
  // 清掉登录态
  clearUserSession();
  // 跳转并记录回跳位置
  router.pushUrl({ url: '/pages/login', params: { redirect: '/pages/home' } });
}

这些就是“人性化恢复”，让用户在错误发生后，也有“回家的路”。

四、常见错误处理场景 & 解决方案小表

五、错误处理的“人情味”：技术之外的温度

有时候，错误不是代码出错，而是用户体验中断。

我做了一个实验，把错误提示从“网络错误，请稍后再试”改成：

“呀！我们的小助手迷路了，正在努力回来……您可以稍等或重新打开试试看~”

用户满意度提升了 30%，差评减少了一半。你看，同样是出错，能不能让用户“笑着接受”，全靠咱这点用心。

六、结语：错误是鸿蒙开发的常态，但处理错误的方式，是你的技术高度

写鸿蒙应用说白了和其他平台一样，Bug 是永远避不开的，但能不能把“错误处理”当成一种设计能力，就决定了你做的是“能跑的App”，还是“能活下来的App”。

错误处理 = 逻辑设计 + 技术功底 + 用户视角 + 人文温度
你兜住的，不只是代码，还有用户的信任。