HarmonyOS NEXT鸿蒙开发 ArkTS：异常处理（try, catch, finally,throw,Error）-马育民老师

# 提出问题

假设由用户输入 `s` 的值，然后执行解析为 JSON，当用户赋值 `s` 不符合 JSON 格式时，就会抛出异常，**中断程序运行**，如下：

```
console.log("执行开始")
let s:string = "{ abc }" // 用户赋值 `s` 不符合 JSON 格式
JSON.parse(s); // 因为解析错误，抛出异常，程序不再继续运行

let res = 1 + 3  // 没有执行该行代码
console.log("执行结束，res：",res) // 没有执行该行代码
```

这是非常严重的错误：不能因为一个错误，导致程序不再继续往下运行，比如windows操作系统，不能因为一个错误就蓝屏死机

### 解决

使用异常处理：捕获异常 (try...catch)

# 介绍

ArkTS 继承了 TypeScript/JavaScript 的 `try...catch...finally` 异常处理模型。当程序执行过程中发生错误时，会创建一个 **异常对象** 并将其 **抛出**。

开发者可以使用 `try...catch` 结构来捕获这个异常，防止程序崩溃。

### 概念：throw, try, catch, finally

*   **`throw`**: 用于**主动抛出**一个异常。
*   **`try`**: 包裹可能**抛出异常**的代码块。
*   **`catch`**: 定义一个块来**捕获并处理**从 `try` 块中抛出的异常。
*   **`finally`**: 定义一个块，无论是否发生异常，都会**最终执行**，通常用于资源清理。

# 捕获异常 (try...catch)

使用 `try...catch` 来安全地执行可能出错的代码

```typescript
console.log("执行开始")
let s:string = "{ abc }"
try {
  // 可能抛出异常的代码
  JSON.parse(s); // 解析错误格式的JSON
} catch (error) {
  // 处理捕获到的异常
  console.error("捕获异常:", error);
}
let res = 1 + 3  // 仍然执行该行代码
console.log("执行结束，res：",res) // 仍然执行该行代码
```

### catch中的异常类型

catch中的异常类型是 `any` 类型

# Error 异常类

所有内置异常（如 TypeError、RangeError）和自定义异常都继承自 `Error` 类

### 包含属性

- **message**：错误描述信息（字符串），通过 `Error` 构造函数传入
- **name**：（字符串）错误的类型名称，用于区分不同异常类型。
 - 内置类型的 name 固定：如 `TypeError` 的 name 是 `"TypeError"`。
 - 自定义异常需 **手动设置**（否则默认继承 `Error` 的 `name`，即：`"Error"` ）。
- stack：错误堆栈跟踪（包含错误发生的位置和调用链）

### 例子

```typescript
console.log("执行开始")
let s:string = "{ abc }"
try {
  // 可能抛出异常的代码
  JSON.parse(s); // 解析错误格式的JSON
} catch (error) {
  // 处理捕获到的异常
  console.error("捕获异常，name:", error.name);
  console.error("捕获异常，message:", error.message);
  console.error("捕获异常，stack:", error.stack);
}
let res = 1 + 3  // 仍然执行该行代码
console.log("执行结束，res：",res) // 仍然执行该行代码
```

# finally 代码块

有时，一些特定的代码 **无论异常是否发生**，**都需要执行**。另外，因为异常会引发** 程序跳转**，导致有些语句 **执行不到**。

finally 就是解决这个问题的，在```finally代码块```中的代码 **一定会执行**。

### 应用场景

当我们在try语句块中打开了一些物理资源(磁盘文件/网络连接/数据库连接等),我们都得在 **使用完之后**，及时 **关闭**。

### 语法
```
try{

}catch(){

}finally{

}
```
或者
```
try{

}finally{

}
```
**注意：** finally代码块不能单独使用。

**例子：**

```java
console.log("执行开始")
let s:string = "{ abc }"
// let s:string = '{ "name":"李雷" }'
try {
  // 可能抛出异常的代码
  JSON.parse(s); // 解析错误格式的JSON
} catch (error) {
  // 处理捕获到的异常
  console.error("捕获异常:", error);
} finally {
  console.log("一定会执行finally代码块")
}
let res = 1 + 3  // 仍然执行该行代码
console.log("执行结束，res：",res) // 仍然执行该行代码
```

# 抛出异常 (throw)

### 为什么要抛出异常

定义 `login()` 登录函数如下，调用该函数登录时，如果登录成功就返回 `True`，如果 **用户名或密码错误** 就返回 `False`

这种设计是不好的，没有错误信息，即：**不知道用户名不存在，还是密码错误**

```
function login(username:string,password:string) : boolean{
  let ret:boolean = false
  if(username == 'lilei' ){
    if(password == '123456'){
      ret = true
    }else{
      ret = false
    }
  }else{
    ret = false
  }
  return ret
}
```

调用 `login()` 函数进行登录：

```
let res : boolean = login("lilei", "123")
if (res){
  console.log("登录成功")
}else {
  console.log("登录失败")
}
```

### 解决

定义 `login()` 函数，登录失败时，使用 `throw` 语句抛出异常，将 **登录错误信息封装到异常对象中**

```
function login(username:string,password:string) : boolean{
  let ret:boolean = false
  if(username == 'lilei' ){
    if(password == '123456'){
      ret = true
    }else{
      throw Error("密码错误！")
    }
  }else{
    throw Error("用户名不存在！")
  }
  return ret
}
```

调用该函数，并且用 `try...catch` 捕获异常，如下：

```
try {
  // login("lilei", "123") // 提示密码错误
  login("hanmeimei", "123456") // 提示用户名不存在
  // login("lilei", "123456") // 登录成功
}catch (error){
  console.log("登录失败：",error.message)
}
console.log("登录成功")
```

### 注意

虽然可以抛出任何值，但 **强烈推荐抛出 `Error` 或其子类的实例**。

```typescript
// ❌ 不推荐：抛出原始值（缺乏上下文）
throw "网络连接失败";

// ✅ 推荐：抛出 Error 对象（包含消息和堆栈跟踪）
throw new Error("网络连接失败");

// 你也可以抛出其他类型的对象，但 Error 是标准做法
throw { code: 404, message: "页面未找到" };
```

# 创建自定义错误类

为了更好地组织和分类错误，建议创建自定义错误类，然后抛出该自定义类。

### 例子：登录错误

定义登录失败异常：

```
class LoginError extends Error {
  constructor(message: string) {
    super(message);
    this.name = "LoginError" // 否则继承 Error，即：值为 "Error"
  }
}
```

定义验证密码不符合要求异常：

```
class ValidPasswordError extends Error {
  constructor(message: string) {
    super(message);
    this.name = "ValidPasswordError" // 否则继承 Error，即：值为 "Error"
  }
}
```

定义登录函数：

```
function login(username:string,password:string) : boolean{
  let ret:boolean = false
  // 校验密码长度
  if(password.length < 6){
    throw new ValidPasswordError("密码长度不足6位，请重新输入！")
  }
  if(username == 'lilei' ){
    if(password == '123456'){
      ret = true
    }else{
      throw new LoginError("密码错误！")
    }
  }else{
    throw new LoginError("用户名不存在！")
  }
  return ret
}
```

执行登录：

```
try {
  login("lilei", "123") // 提示：密码不符合要求： 密码长度不足6位，请重新输入！
  // login("hanmeimei", "123456") // 提示：登录失败： 用户名不存在！
  // login("lilei", "123456")
  console.log("登录成功")
}catch (error){
  // 进行类型检查，否则不知道抛的是哪个异常
  if(error instanceof LoginError) {
    console.log("登录失败：", error.message)
  }else if(error instanceof ValidPasswordError){ // 必须进行类型检查
    console.log("密码不符合要求：",error.message)
  }
}
```

# 异常处理建议

### 向用户反馈

不要让错误只停留在控制台。使用 HarmonyOS 提供的 UI 组件向用户反馈：

*   **`prompt.showToast`**: 显示短暂的提示信息。
*   **更新 `@State` 变量**: 在 UI 组件中显示错误消息（如上例所示）。
*   **弹窗 (`AlertDialog`)**: 对于严重错误，使用对话框告知用户。

### 记录日志

使用 `console.log`, `console.error` 记录关键错误，便于调试和线上问题排查。

```typescript
console.error("[UserService] 获取用户信息失败:", error);
```

### 资源清理

在 `finally` 块中确保关闭文件流、取消定时器、解除事件监听等。

### 避免吞掉异常

除非有充分理由，否则不要捕获异常后不做任何处理（“吞掉”异常），这会让问题难以发现。

```typescript
// ❌ 避免这样做
try {
  riskyCall();
} catch (error) {
  // 什么也不做
}
```

### 预防性检查

在某些情况下，可以通过前置检查来避免异常的发生，而不是依赖 `try...catch`。

```typescript
// 更好的方式：先检查
if (array && array.length > 0) {
  const firstItem = array[0];
}

// 而不是：
// try {
//   const firstItem = array[0];
// } catch (error) { ... }
```

# 总结

在 ArkTS 中处理异常是构建高质量 HarmonyOS 应用的必备技能。记住以下要点：

1.  **使用 `try...catch`**: 保护可能出错的代码。
2.  **抛出 `Error` 实例**: 提供清晰的错误信息和堆栈。
3.  **创建自定义错误**: 使错误分类更清晰。
4.  **处理 `unknown`**: 在 `catch` 块中进行类型检查。
5.  **善用 `async/await`**: 清晰处理异步错误。
6.  **及时反馈用户**: 使用 Toast 或 UI 更新告知用户状态。
7.  **记录和清理**: 记录日志，清理资源。

通过遵循这些原则，您可以显著提升应用的稳定性和用户体验。

原文出处：http://www.malaoshi.top/show_1GW20c0hudh5.html