当前位置：首页 > news >正文

try/catch/finally：完善的错误处理策略

news 2026/3/27 1:31:23

try/catch/finally：完善的错误处理策略

概述

在 HarmonyOS 应用开发中，错误处理是保证应用稳定性和用户体验的关键环节。本文将深入探讨 HarmonyOS Next（API 10 及以上版本）中的错误处理机制，帮助开发者构建更加健壮的应用程序。

官方参考资料：

HarmonyOS ArkTS 语法介绍
MDN-try-catch

基础错误处理机制

try/catch 基础语法

在 HarmonyOS 应用开发中，try/catch 是处理运行时错误的基本结构。以下是基础语法示例：

// 基础try/catch示例
class BasicErrorHandling {static divideNumbers(a: number, b: number): number {try {if (b === 0) {throw new Error("除数不能为零");}return a / b;} catch (error) {console.error("计算过程中发生错误:", error.message);return NaN;}}
}// 使用示例
let result = BasicErrorHandling.divideNumbers(10, 2); // 正常执行
console.log("结果:", result); // 输出: 结果: 5let errorResult = BasicErrorHandling.divideNumbers(10, 0); // 触发错误
console.log("错误结果:", errorResult); // 输出: 错误结果: NaN

finally 块的使用

finally 块确保无论是否发生错误，特定代码都会被执行：

class FileProcessor {static processFile(filePath: string): void {let fileHandle: File | null = null;try {// 模拟文件打开操作fileHandle = this.openFile(filePath);console.log("文件处理中...");// 模拟处理过程中可能出现的错误if (filePath.includes("corrupt")) {throw new Error("文件损坏，无法处理");}console.log("文件处理完成");} catch (error) {console.error("文件处理失败:", error.message);} finally {// 无论是否发生错误，都会执行清理工作if (fileHandle) {this.closeFile(fileHandle);console.log("文件已关闭");}}}private static openFile(path: string): File {// 模拟打开文件操作console.log(`打开文件: ${path}`);return new File();}private static closeFile(file: File): void {// 模拟关闭文件操作console.log("关闭文件");}
}// 使用示例
FileProcessor.processFile("normal.txt");
FileProcessor.processFile("corrupt.txt");

错误类型详解

内置错误类型

HarmonyOS 提供了多种内置错误类型，用于处理不同类型的异常情况：

class ErrorTypesDemo {static demonstrateErrorTypes(): void {try {// 1. RangeError - 数值越界this.checkRange(150);// 2. TypeError - 类型错误this.validateType("invalid");// 3. ReferenceError - 引用错误this.accessUndefined();} catch (error) {this.handleSpecificError(error);}}private static checkRange(value: number): void {if (value > 100) {throw new RangeError(`数值 ${value} 超出允许范围(0-100)`);}}private static validateType(input: any): void {if (typeof input !== "number") {throw new TypeError(`期望数字类型，但收到 ${typeof input}`);}}private static accessUndefined(): void {const undefinedVar = undefined;// 模拟引用错误if (undefinedVar === undefined) {throw new ReferenceError("尝试访问未定义的变量");}}private static handleSpecificError(error: Error): void {if (error instanceof RangeError) {console.error("范围错误:", error.message);} else if (error instanceof TypeError) {console.error("类型错误:", error.message);} else if (error instanceof ReferenceError) {console.error("引用错误:", error.message);} else {console.error("未知错误:", error.message);}}
}

错误类型对比表

错误类型	触发条件	典型使用场景
`Error`	通用错误	自定义业务逻辑错误
`RangeError`	数值超出有效范围	数组索引、数值验证
`TypeError`	变量类型不符合预期	参数类型检查、API 调用
`ReferenceError`	引用未定义的变量	变量作用域问题
`SyntaxError`	语法解析错误	动态代码执行

高级错误处理技巧

自定义错误类

创建自定义错误类可以提供更详细的错误信息和更好的类型安全：

// 自定义网络错误类
class NetworkError extends Error {public readonly statusCode: number;public readonly url: string;public readonly timestamp: Date;constructor(message: string, statusCode: number, url: string) {super(message);this.name = "NetworkError";this.statusCode = statusCode;this.url = url;this.timestamp = new Date();}toString(): string {return `${this.timestamp.toISOString()} - ${this.name}: ${this.message} (Status: ${this.statusCode}, URL: ${this.url})`;}
}// 自定义验证错误类
class ValidationError extends Error {public readonly field: string;public readonly value: any;public readonly rule: string;constructor(field: string, value: any, rule: string, message?: string) {super(message || `字段 '${field}' 验证失败`);this.name = "ValidationError";this.field = field;this.value = value;this.rule = rule;}
}// 使用自定义错误类
class ApiService {static async fetchData(url: string): Promise<any> {try {// 模拟API调用const response = await this.mockApiCall(url);if (response.status >= 400) {throw new NetworkError(`API调用失败: ${response.statusText}`,response.status,url);}return response.data;} catch (error) {if (error instanceof NetworkError) {console.error("网络错误详情:", error.toString());}throw error; // 重新抛出错误}}private static async mockApiCall(url: string): Promise<any> {// 模拟API响应return new Promise((resolve, reject) => {setTimeout(() => {if (url.includes("timeout")) {reject(new NetworkError("请求超时", 408, url));} else if (url.includes("404")) {resolve({ status: 404, statusText: "Not Found", data: null });} else {resolve({status: 200,statusText: "OK",data: { result: "success" },});}}, 100);});}
}

嵌套错误处理

复杂的应用场景中可能需要多层错误处理：

class NestedErrorHandling {static async processUserData(userId: string): Promise<void> {try {console.log(`开始处理用户数据: ${userId}`);// 外层处理：数据验证const validatedData = await this.validateUserData(userId);try {// 内层处理：数据处理const processedData = await this.processData(validatedData);try {// 最内层：数据保存await this.saveData(processedData);console.log("数据处理完成");} catch (saveError) {console.error("数据保存失败:", saveError.message);throw new Error(`数据处理完成但保存失败: ${saveError.message}`);}} catch (processError) {console.error("数据处理失败:", processError.message);throw new Error(`数据验证通过但处理失败: ${processError.message}`);}} catch (outerError) {console.error("用户数据处理整体失败:", outerError.message);// 可以在这里进行统一的错误上报this.reportError(outerError);}}private static async validateUserData(userId: string): Promise<any> {if (!userId || userId.length === 0) {throw new ValidationError("userId", userId, "非空", "用户ID不能为空");}return { userId, timestamp: new Date() };}private static async processData(data: any): Promise<any> {// 模拟数据处理if (data.userId === "invalid") {throw new Error("无效的用户数据");}return { ...data, processed: true };}private static async saveData(data: any): Promise<void> {// 模拟数据保存if (data.userId === "save_fail") {throw new Error("数据库连接失败");}console.log("数据保存成功");}private static reportError(error: Error): void {// 模拟错误上报console.log(`错误已上报: ${error.name} - ${error.message}`);}
}

异步错误处理

Promise 错误处理

在异步编程中，Promise 的错误处理需要特别注意：

class AsyncErrorHandling {// 使用async/await的错误处理static async fetchWithAsyncAwait(url: string): Promise<any> {try {const response = await this.simulateFetch(url);return response.data;} catch (error) {console.error("异步请求失败:", error.message);throw error;}}// 使用Promise链的错误处理static fetchWithPromiseChain(url: string): Promise<any> {return this.simulateFetch(url).then((response) => {return response.data;}).catch((error) => {console.error("Promise链错误:", error.message);throw new Error(`数据获取失败: ${error.message}`);});}// 多个异步操作的错误处理static async multipleAsyncOperations(): Promise<void> {try {// 并行执行多个异步操作const [userData, settings, preferences] = await Promise.all([this.fetchUserData(),this.fetchUserSettings(),this.fetchUserPreferences(),]);console.log("所有数据获取成功");} catch (error) {console.error("多个异步操作中发生错误:", error.message);}}// 使用Promise.allSettled处理部分失败的情况static async robustMultipleAsyncOperations(): Promise<void> {const results = await Promise.allSettled([this.fetchUserData(),this.fetchUserSettings(),this.fetchUserPreferences(),]);const errors: Error[] = [];const successfulResults: any[] = [];results.forEach((result, index) => {if (result.status === "fulfilled") {successfulResults.push(result.value);} else {errors.push(result.reason);console.error(`操作 ${index} 失败:`, result.reason.message);}});if (errors.length > 0) {console.warn(`${errors.length} 个操作失败，但应用继续运行`);}console.log(`成功完成 ${successfulResults.length} 个操作`);}private static simulateFetch(url: string): Promise<any> {return new Promise((resolve, reject) => {setTimeout(() => {if (url.includes("error")) {reject(new Error(`模拟网络错误: ${url}`));} else {resolve({ data: { url, content: "模拟数据" } });}}, 100);});}private static async fetchUserData(): Promise<any> {// 模拟API调用return { user: "示例用户" };}private static async fetchUserSettings(): Promise<any> {// 模拟可能失败的操作throw new Error("设置获取失败");}private static async fetchUserPreferences(): Promise<any> {return { theme: "dark" };}
}

异步错误处理模式对比表

处理模式	优点	缺点	适用场景
`async/await + try/catch`	代码清晰，同步风格	需要层层传递错误	大多数异步场景
`Promise.catch()`	链式调用，简洁	错误处理分散	Promise 链式操作
`Promise.allSettled()`	部分失败不影响整体	需要额外处理结果	批量独立操作
`window.onunhandledrejection`	全局捕获未处理错误	无法恢复执行	错误监控和上报

实际应用场景

UI 组件错误处理

在 HarmonyOS UI 开发中，合理的错误处理可以提升用户体验：

@Entry
@Component
struct ErrorHandlingExample {@State message: string = '点击按钮测试错误处理';@State isLoading: boolean = false;@State errorInfo: string = '';build() {Column({ space: 20 }) {Text(this.message).fontSize(20).fontColor(this.errorInfo ? Color.Red : Color.Black)if (this.errorInfo) {Text(`错误信息: ${this.errorInfo}`).fontSize(16).fontColor(Color.Red).backgroundColor(Color.White).padding(10).border({ width: 1, color: Color.Red })}if (this.isLoading) {LoadingProgress().color(Color.Blue)}Button('模拟成功操作').onClick(() => {this.handleOperation('success');}).width('80%')Button('模拟失败操作').onClick(() => {this.handleOperation('failure');}).width('80%').backgroundColor(Color.Orange)Button('重置状态').onClick(() => {this.resetState();}).width('80%').backgroundColor(Color.Gray)}.width('100%').height('100%').padding(20).alignItems(HorizontalAlign.Center).justifyContent(FlexAlign.Center)}private async handleOperation(type: string): Promise<void> {this.isLoading = true;this.errorInfo = '';try {const result = await this.simulateOperation(type);this.message = `操作成功: ${result}`;} catch (error) {this.errorInfo = error.message;this.message = '操作失败，请查看错误信息';// 记录错误日志console.error(`UI操作错误: ${error.message}`, error);} finally {this.isLoading = false;}}private async simulateOperation(type: string): Promise<string> {return new Promise((resolve, reject) => {setTimeout(() => {if (type === 'success') {resolve('数据加载完成');} else {reject(new Error('网络连接超时，请检查网络设置'));}}, 1500);});}private resetState(): void {this.message = '点击按钮测试错误处理';this.errorInfo = '';this.isLoading = false;}
}