Flutter for OpenHarmony 视力保护提醒App实战 - 错误处理与异常管理-程序员充电站

概述

错误处理和异常管理是应用开发的重要方面，它直接影响应用的稳定性和用户体验。在视力保护提醒应用中，我们采用了完整的错误处理机制来确保应用的稳定运行。本文将详细讲解如何进行错误处理和异常管理，包括异常捕获、错误提示、日志记录、恢复机制等功能。

错误处理的核心方面

错误处理主要包含以下方面：

异常捕获- 捕获和处理异常
错误提示- 向用户显示错误信息
日志记录- 记录错误日志用于调试
恢复机制- 从错误中恢复

这些方面结合在一起，为应用提供了一个完整的错误处理解决方案。

项目依赖配置

在pubspec.yaml中，我们已经配置了所需的依赖：

dependencies:flutter:sdk:flutterget:^4.6.5

get库提供了snackbar功能用于显示错误提示。这个依赖是为了支持鸿蒙系统的Flutter开发。

基础异常捕获

使用try-catch捕获异常。

Future<void>loadData()async{try{finaldata=await_fetchDataFromServer();setState((){_data=data;});}catch(e){print('加载数据失败:$e');Get.snackbar('错误','加载数据失败，请重试',snackPosition:SnackPosition.BOTTOM,backgroundColor:Colors.red,colorText:Colors.white,);}}

使用try-catch可以捕获异常并进行处理。在catch块中，我们可以记录错误并向用户显示错误提示。

异常分类处理

根据异常类型进行不同的处理。

Future<void>loadData()async{try{finaldata=await_fetchDataFromServer();setState((){_data=data;});}onSocketException{Get.snackbar('网络错误','网络连接失败，请检查网络设置',snackPosition:SnackPosition.BOTTOM,backgroundColor:Colors.red,colorText:Colors.white,);}onTimeoutException{Get.snackbar('超时错误','请求超时，请重试',snackPosition:SnackPosition.BOTTOM,backgroundColor:Colors.orange,

根据异常类型进行不同的处理，可以提供更准确的错误提示。这种分类处理方式能够帮助用户更好地理解错误原因。SocketException表示网络连接问题，TimeoutException表示请求超时。通过捕获不同的异常类型，我们可以为用户显示相应的错误信息和建议。这样可以提高应用的用户体验，让用户知道具体发生了什么问题。

colorText:Colors.white,);}catch(e){Get.snackbar('未知错误','发生未知错误，请重试',snackPosition:SnackPosition.BOTTOM,backgroundColor:Colors.red,colorText:Colors.white,);}}

根据异常类型进行不同的处理，可以提供更准确的错误提示。

自定义异常

创建自定义异常类。

classAppExceptionimplementsException{finalStringmessage;finalString?code;AppException({requiredthis.message,this.code,});@overrideStringtoString()=>'AppException:$message(code:$code)';}classNetworkExceptionextendsAppException{NetworkException({String?message}):super(message:message??'网络连接失败',code:'NETWORK_ERROR',);}

自定义异常类提供了更清晰的错误信息和错误代码。通过继承AppException基类，我们可以创建特定的异常类型，如NetworkException、DataException等。每个异常类都有自己的错误代码和默认错误信息。这样可以在应用中统一处理异常，提供一致的错误处理体验。自定义异常还可以包含更多的上下文信息，帮助开发者快速定位问题。

classDataExceptionextendsAppException{DataException({String?message}):super(message:message??'数据加载失败',code:'DATA_ERROR',);}// 使用自定义异常Future<void>loadData()async{try{if(!await_checkNetworkConnection()){throwNetworkException();}finaldata=await_fetchDataFromServer();if(data==null){throwDataException();}setState((){_data=data;});}onAppExceptioncatch(e){Get.snackbar('错误',e.message,snackPosition:SnackPosition.BOTTOM,backgroundColor:Colors.red,colorText:Colors.white,);}}

自定义异常可以提供更清晰的错误信息和错误代码。

日志记录

记录错误日志用于调试。

classLogger{staticvoidlog(Stringmessage){print('[LOG]$message');}staticvoiderror(Stringmessage,[Object?error,StackTrace?stackTrace]){print('[ERROR]$message');if(error!=null){print('[ERROR] Error:$error');}if(stackTrace!=null){print('[ERROR] StackTrace:$stackTrace');}}staticvoidwarning(Stringmessage){print('[WARNING]$message');}}

记录详细的错误日志可以帮助开发者快速定位问题。Logger类提供了三个静态方法：log用于记录普通日志，error用于记录错误信息和堆栈跟踪，warning用于记录警告信息。通过在关键位置添加日志记录，我们可以追踪应用的执行流程。当出现问题时，这些日志可以提供宝贵的调试信息。在生产环境中，可以将日志上传到服务器进行分析。

// 使用日志记录Future<void>loadData()async{try{Logger.log('开始加载数据');finaldata=await_fetchDataFromServer();Logger.log('数据加载成功');setState((){_data=data;});}catch(e,stackTrace){Logger.error('数据加载失败',e,stackTrace);Get.snackbar('错误','加载数据失败，请重试',snackPosition:SnackPosition.BOTTOM,backgroundColor:Colors.red,colorText:Colors.white,);}}

记录详细的错误日志可以帮助开发者快速定位问题。

错误恢复机制

实现错误恢复机制。

classDataManager{staticconstint maxRetries=3;staticFuture<T>retryOperation<T>(Future<T>Function()operation,{int maxRetries=maxRetries,Durationdelay=constDuration(seconds:1),})async{int retryCount=0;while(retryCount<maxRetries){try{returnawaitoperation();}catch(e){retryCount++;if(retryCount>=maxRetries){rethrow;}Logger.warning('操作失败，${delay.inSeconds}秒后重试 (${retryCount}/${maxRetries})');awaitFuture.delayed(delay);}

实现重试机制可以在网络不稳定时自动重试操作。retryOperation方法接收一个异步操作函数，并在失败时自动重试。通过maxRetries参数控制最大重试次数，通过delay参数控制重试间隔。这种机制特别适合处理网络请求，因为网络可能会因为临时问题而失败。通过自动重试，我们可以提高应用的可靠性，减少用户遇到的错误。

}throwException('操作失败');}}// 使用重试机制Future<void>loadData()async{try{finaldata=awaitDataManager.retryOperation(()=>_fetchDataFromServer(),maxRetries:3,delay:constDuration(seconds:2),);setState((){_data=data;});}catch(e){Logger.error('数据加载失败',e);Get.snackbar('错误','加载数据失败，请重试',snackPosition:SnackPosition.BOTTOM,backgroundColor:Colors.red,colorText:Colors.white,);}}

实现重试机制可以在网络不稳定时自动重试操作。

全局错误处理

在应用级别处理全局错误。

voidmain(){FlutterError.onError=(FlutterErrorDetailsdetails){Logger.error('Flutter错误',details.exception,details.stack);};runZonedGuarded((){runApp(constMyApp());},(error,stackTrace){Logger.error('应用错误',error,stackTrace);},);}

使用FlutterError.onError和runZonedGuarded可以捕获全局错误。

表单验证错误处理

处理表单验证错误。

Widget_buildFormField(Stringlabel,TextEditingControllercontroller){returnColumn(crossAxisAlignment:CrossAxisAlignment.start,children:[Text(label,style:TextStyle(fontSize:12.sp,fontWeight:FontWeight.w500),),SizedBox(height:4.h),TextField(controller:controller,decoration:InputDecoration(border:OutlineInputBorder(borderRadius:BorderRadius.circular(8.r),),contentPadding:EdgeInsets.symmetric(horizontal:12.w,vertical:10.h),errorText:_validateField(controller.text),),),],

在表单字段中显示验证错误信息。这个方法构建了一个带有验证功能的文本输入字段。当用户输入内容时，_validateField方法会检查输入的有效性。如果验证失败，errorText会显示相应的错误信息。这种实时验证方式可以帮助用户及时发现和纠正输入错误。通过在TextField的decoration中设置errorText，Flutter会自动以红色显示错误信息。

);}String?_validateField(Stringvalue){if(value.isEmpty){return'此字段不能为空';}if(value.length<2){return'至少需要2个字符';}returnnull;}

在表单字段中显示验证错误信息。

网络错误处理

处理网络相关的错误。

Future<T>_handleNetworkRequest<T>(Future<T>Function()request)async{try{returnawaitrequest();}onSocketException{throwNetworkException(message:'网络连接失败');}onTimeoutException{throwNetworkException(message:'请求超时');}onHttpExceptioncatch(e){throwNetworkException(message:'服务器错误:${e.message}');}catch(e){throwNetworkException(message:'网络请求失败');}}