首页 资讯中心 文章详情

网络拦截器 - Flutter在鸿蒙平台处理HTTP请求

发布时间：2026/7/23 2:18:26
网络拦截器 - Flutter在鸿蒙平台处理HTTP请求 概述在Flutter应用开发中网络请求是不可或缺的一部分。为了统一处理HTTP请求的认证、日志、错误处理等逻辑使用拦截器是一个很好的实践。Dio库提供了强大的拦截器机制可以在请求发送前、响应返回后、错误发生时进行统一处理。本文将详细介绍网络拦截器的核心概念、使用方法、高级特性以及在鸿蒙平台上的实现细节。核心概念什么是网络拦截器网络拦截器是一种中间件机制允许在HTTP请求的各个阶段插入自定义逻辑阶段拦截器类型作用请求发送前请求拦截器添加认证信息、日志记录、参数加密响应返回后响应拦截器数据解析、日志记录、错误处理错误发生时错误拦截器错误重试、错误转换、错误上报拦截器的优势代码复用将通用逻辑抽离到拦截器中统一处理集中处理认证、日志、错误等逻辑易于维护修改逻辑只需改动拦截器解耦合业务代码与网络层解耦拦截器链多个拦截器可以组成一个拦截器链按照顺序执行请求 → 拦截器1 → 拦截器2 → ... → 服务器 响应 → 拦截器n → 拦截器n-1 → ... → 业务代码基本使用安装依赖dependencies:dio:^5.4.0创建请求拦截器importpackage:dio/dio.dart;classAuthInterceptorextendsInterceptor{overridevoidonRequest(RequestOptionsoptions,RequestInterceptorHandlerhandler){options.headers[Authorization]Bearer token;super.onRequest(options,handler);}}创建响应拦截器classLoggingInterceptorextendsInterceptor{overridevoidonResponse(Responseresponse,ResponseInterceptorHandlerhandler){print(RESPONSE:${response.data});super.onResponse(response,handler);}}添加拦截器到DiofinaldioDio();dio.interceptors.add(AuthInterceptor());dio.interceptors.add(LoggingInterceptor());核心代码示例代码示例1认证拦截器importpackage:dio/dio.dart;importpackage:shared_preferences/shared_preferences.dart;classAuthInterceptorextendsInterceptor{overridevoidonRequest(RequestOptionsoptions,RequestInterceptorHandlerhandler)async{finalprefsawaitSharedPreferences.getInstance();finaltokenprefs.getString(access_token);if(token!null){options.headers[Authorization]Bearer$token;}options.headers[Content-Type]application/json;super.onRequest(options,handler);}overridevoidonResponse(Responseresponse,ResponseInterceptorHandlerhandler){if(response.statusCode401){}super.onResponse(response,handler);}overridevoidonError(DioExceptionerr,ErrorInterceptorHandlerhandler){if(err.response?.statusCode401){}super.onError(err,handler);}}代码说明请求拦截在请求发送前添加认证token和Content-Type响应拦截处理401状态码token过期错误拦截处理请求错误时的401状态码异步操作使用SharedPreferences获取token代码示例2日志拦截器classLoggingInterceptorextendsInterceptor{overridevoidonRequest(RequestOptionsoptions,RequestInterceptorHandlerhandler){print(REQUEST[${options.method}] PATH:${options.path});print(HEADERS:${options.headers});if(options.data!null){print(BODY:${options.data});}super.onRequest(options,handler);}overridevoidonResponse(Responseresponse,ResponseInterceptorHandlerhandler){print(RESPONSE[${response.statusCode}] PATH:${response.requestOptions.path});print(DATA:${response.data});super.onResponse(response,handler);}overridevoidonError(DioExceptionerr,ErrorInterceptorHandlerhandler){print(ERROR[${err.response?.statusCode}] PATH:${err.requestOptions.path});print(ERROR:$err);super.onError(err,handler);}}代码说明请求日志记录请求方法、路径、头信息和请求体响应日志记录响应状态码、路径和响应数据错误日志记录错误状态码、路径和错误信息调试方便帮助开发者调试网络请求代码示例3API客户端封装importpackage:dio/dio.dart;classApiClient{staticlateDio_dio;staticvoidinit(){_dioDio(BaseOptions(baseUrl:https://api.example.com,connectTimeout:constDuration(seconds:10),receiveTimeout:constDuration(seconds:10),));_dio.interceptors.add(AuthInterceptor());_dio.interceptors.add(LoggingInterceptor());_dio.interceptors.add(RetryInterceptor(dio:_dio,options:constRetryOptions(retries:3,retryInterval:Duration(seconds:1),retryEvaluator:_defaultRetryEvaluator,),));}staticbool_defaultRetryEvaluator(DioExceptionerror){returnerror.typeDioExceptionType.connectionTimeout||error.typeDioExceptionType.receiveTimeout||error.typeDioExceptionType.sendTimeout;}staticDiogetinstance_dio;staticFutureResponseget(Stringpath,{MapString,dynamic?queryParameters})async{returnawait_dio.get(path,queryParameters:queryParameters);}staticFutureResponsepost(Stringpath,{dynamicdata})async{returnawait_dio.post(path,data:data);}staticFutureResponseput(Stringpath,{dynamicdata})async{returnawait_dio.put(path,data:data);}staticFutureResponsedelete(Stringpath)async{returnawait_dio.delete(path);}}代码说明单例模式使用静态实例避免重复创建基础配置设置baseUrl、超时时间拦截器链添加认证、日志、重试拦截器请求方法封装GET、POST、PUT、DELETE方法重试逻辑对超时错误自动重试3次代码示例4错误处理拦截器classErrorInterceptorextendsInterceptor{overridevoidonError(DioExceptionerr,ErrorInterceptorHandlerhandler){finalerrorMessage_getErrorMessage(err);print(Error:$errorMessage);finalcustomErrorApiError(code:err.response?.statusCode??-1,message:errorMessage,originalError:err,);handler.reject(DioException(requestOptions:err.requestOptions,error:customError,type:err.type,response:err.response,));}String_getErrorMessage(DioExceptionerr){switch(err.type){caseDioExceptionType.connectionTimeout:return连接超时;caseDioExceptionType.sendTimeout:return发送超时;caseDioExceptionType.receiveTimeout:return接收超时;caseDioExceptionType.badResponse:return服务器错误${err.response?.statusCode};caseDioExceptionType.cancel:return请求已取消;caseDioExceptionType.connectionError:return网络连接错误;default:return未知错误;}}}classApiError{finalint code;finalStringmessage;finalDioExceptionoriginalError;ApiError({requiredthis.code,requiredthis.message,requiredthis.originalError,});}代码说明错误转换将DioException转换为自定义ApiError错误消息根据错误类型提供友好的错误消息错误信息保存原始错误信息便于调试错误码提取HTTP状态码高级特性1. 请求重试dio.interceptors.add(RetryInterceptor(dio:dio,options:constRetryOptions(retries:3,retryInterval:Duration(seconds:1),retryEvaluator:(error)error.typeDioExceptionType.connectionTimeout,),));2. 请求缓存classCacheInterceptorextendsInterceptor{finalMapString,Response_cache{};overridevoidonRequest(RequestOptionsoptions,RequestInterceptorHandlerhandler){if(options.methodGET){finalcachedResponse_cache[options.path];if(cachedResponse!null){handler.resolve(cachedResponse);return;}}handler.next(options);}overridevoidonResponse(Responseresponse,ResponseInterceptorHandlerhandler){if(response.requestOptions.methodGET){_cache[response.requestOptions.path]response;}handler.next(response);}}3. 请求限流classRateLimitInterceptorextendsInterceptor{int _requestCount0;DateTime?_lastResetTime;overridevoidonRequest(RequestOptionsoptions,RequestInterceptorHandlerhandler){finalnowDateTime.now();if(_lastResetTimenull||now.difference(_lastResetTime!)constDuration(seconds:1)){_requestCount0;_lastResetTimenow;}if(_requestCount10){handler.reject(DioException(requestOptions:options,error:Rate limit exceeded,));}else{_requestCount;handler.next(options);}}}4. 参数加密classEncryptionInterceptorextendsInterceptor{overridevoidonRequest(RequestOptionsoptions,RequestInterceptorHandlerhandler){if(options.data!null){options.data_encrypt(options.data);}handler.next(options);}dynamic_encrypt(dynamicdata){returndata;}}在鸿蒙平台的实现鸿蒙平台适配鸿蒙平台对Flutter网络请求的支持与Android类似因为鸿蒙兼容Android应用。需要注意以下几点网络权限需要在module.json5中声明网络权限HTTPS支持鸿蒙平台支持HTTPS请求网络代理可以配置网络代理进行调试鸿蒙平台权限配置在module.json5中配置网络权限{module:{requestPermissions:[{name:ohos.permission.INTERNET,reason:需要网络权限发送HTTP请求,usedScene:{ability:[{name:MainAbility,when:inuse}],permissionFlags:[grantMode:system_grant]}}]}}鸿蒙平台注意事项网络安全鸿蒙平台要求使用HTTPS连接证书验证需要正确配置SSL证书代理配置调试时可以配置网络代理性能对比操作无拦截器有拦截器请求时间正常略有增加毫秒级代码复杂度高重复逻辑低统一处理可维护性差好最佳实践1. 封装API客户端将所有网络请求封装在API客户端中classApiClient{staticFutureUsergetUser(int id)async{finalresponseawait_dio.get(/users/$id);returnUser.fromJson(response.data);}staticFutureListUsergetUsers()async{finalresponseawait_dio.get(/users);return(response.dataasList).map((e)User.fromJson(e)).toList();}}2. 统一错误处理在错误拦截器中统一处理错误classErrorInterceptorextendsInterceptor{overridevoidonError(DioExceptionerr,ErrorInterceptorHandlerhandler){finalerror_handleError(err);handler.reject(error);}DioException_handleError(DioExceptionerr){// 统一错误处理逻辑returnerr;}}3. 合理使用拦截器根据需求选择合适的拦截器dio.interceptors.add(AuthInterceptor());dio.interceptors.add(LoggingInterceptor());dio.interceptors.add(ErrorInterceptor());4. 避免重复拦截不要在多个地方添加相同的拦截器// 错误示例dio.interceptors.add(AuthInterceptor());dio.interceptors.add(AuthInterceptor());// 重复添加5. 测试拦截器编写测试用例验证拦截器功能voidmain(){test(AuthInterceptor adds token,()async{finaldioDio();dio.interceptors.add(AuthInterceptor());// 测试拦截器是否正确添加token});}常见问题Q1: 拦截器不生效怎么办A检查以下几点是否正确添加了拦截器到Dio实例拦截器的顺序是否正确是否调用了handler.next()或handler.resolve()Q2: 如何在拦截器中获取上下文A可以通过RequestOptions的extra参数传递上下文dio.get(/users,options:Options(extra:{context:context}));Q3: 拦截器可以异步操作吗A可以请求拦截器支持异步操作overridevoidonRequest(RequestOptionsoptions,RequestInterceptorHandlerhandler)async{finaltokenawaitgetToken();options.headers[Authorization]token;handler.next(options);}Q4: 如何取消请求A使用CancelToken取消请求finalcancelTokenCancelToken();dio.get(/users,cancelToken:cancelToken);cancelToken.cancel(Request cancelled);Q5: 如何处理HTTPS证书问题A可以通过配置Dio的HttpClientAdapter来处理dio.httpClientAdapterHttp2Adapter(ConnectionManager(idleTimeout:constDuration(seconds:10),),);总结网络拦截器是Flutter应用中处理HTTP请求的重要机制通过Dio库的拦截器可以实现认证、日志、错误处理等统一逻辑。在鸿蒙平台上网络拦截器的实现与Android类似但需要注意网络权限和HTTPS配置。选择合适的拦截器需要根据应用需求来决定拦截器适用场景特点认证拦截器需要登录的应用自动添加认证信息日志拦截器开发调试记录请求和响应信息错误拦截器所有应用统一错误处理重试拦截器不稳定网络自动重试失败请求希望本文能帮助你更好地理解和使用网络拦截器在Flutter应用中处理HTTP请求。

相关新闻

Python的数据存储与运算符

Python的数据存储与运算符

2026/7/23 2:18:26

大家好，最近在系统学习 Python 基础，把核心知识点整理成这份笔记，分享给正在入门 Python 的朋友们。零基础学编程，基础概念一定要吃透，下面跟着我的笔记一起梳理重点！1. 变量定义格式Python 定义变量语法十…

Linux下私有化部署MrDoc文档库的实践指南

Linux下私有化部署MrDoc文档库的实践指南

2026/7/23 2:17:26

1. 为什么需要私有化部署的在线文档库？在Linux环境下工作时，我们经常需要处理各种技术文档、配置说明和项目资料。传统的本地文档管理方式存在几个明显痛点：文档分散在各个目录难以查找、多人协作时版本混乱、无法随时随地访问。而公有云文档…

OpenAI模型，自主入侵顶级AI公司系统！后背发凉！

OpenAI模型，自主入侵顶级AI公司系统！后背发凉！

2026/7/23 2:17:26

7月16号的时候，Hugging Face发布了一则公告，公告里面说他们的系统被AI Agent入侵了。 这也是一起前所未有的AI安全事件，然后快速登上热搜，引发全网激烈讨论。Hugging Face 是干嘛的？ Hugging Face 是全球最大的开源 AI…

Linux的几个简单命令

Linux的几个简单命令

2026/7/23 4:00:50

Linux的几个简单命令 一 nc -z -v 15.57.146.228 515 nc：netcat 网络工具 -z：扫描模式，只探测端口连通性，不发送数据 -v：verbose，显示详细过程 15.57.146.228：目标 IP 515：目标端口 端口 515 = LPD/LPR 打印服务端口（老式网络打印协议，CUPS 常用来对接 LPR 打印…

OpenAI广告业务探索：大模型商业化与对话式广告的未来

OpenAI广告业务探索：大模型商业化与对话式广告的未来

2026/7/23 4:00:50

上周，当 OpenAI 宣布其广告业务的最新进展时，我正和一位做搜索产品的朋友讨论技术变现的路径。他半开玩笑地说：“你看，连 OpenAI 都开始认真卖广告了，这大概说明光靠技术理想确实养不活一个大模型。”这让我想起几年前…

亿级数据深度分页优化方案与实战

亿级数据深度分页优化方案与实战

2026/7/23 3:59:50

1. 深度分页的本质与挑战当数据量达到亿级规模时，传统的LIMIT offset, size分页方式会变得极其低效。以MySQL为例，执行SELECT * FROM large_table LIMIT 1000000, 20时，数据库需要先扫描1000020条记录，然后丢弃前100万条&#xff…

福州豪宅整木定制选型：从木皮到安装，核心看这几点

福州豪宅整木定制选型：从木皮到安装，核心看这几点

2026/7/23 3:59:50

对于福州的别墅、大平层业主来说，高端整木定制是决定空间质感的关键一环。好的整木定制不仅能提升空间的整体性与高级感，更能通过精细化的设计满足个性化的生活需求。在挑选整木定制品牌时，很多人会优先对比图森、M77 等一线品牌，…

英力股份官网访问指南与安全识别技巧

英力股份官网访问指南与安全识别技巧

2026/7/23 3:59:50

1. 英力股份官网的正确访问方式最近发现不少人在搜索英力股份的官网时遇到了困扰，作为一家专业的真空设备制造商，英力股份确实拥有自己的官方网站。经过核实，公司唯一正规的官网地址是：https://www.shinyvac.com/这个域名从2015年…

油泥处理设备哪里能买到

油泥处理设备哪里能买到

2026/7/23 0:00:16

油泥处理设备哪里有？这是许多从事油田、炼化、清罐业务的从业者最关心的问题。根据河南三丰环保设备有限公司的行业经验，选购油泥处理设备的核心在于设备能否适配当地环保法规与原料特性，而非单纯看价格。该公司总经理王钦田先生指出&#xf…

Unity与Python本地通信：基于Flask的跨语言数据交换实战

Unity与Python本地通信：基于Flask的跨语言数据交换实战

2026/7/22 11:54:37

1. 项目概述：为什么我们需要一个本地通信服务器？在游戏开发、数字孪生、仿真训练等众多领域，Unity作为强大的实时3D内容创作平台，其核心逻辑通常由C#驱动。然而，当我们需要进行复杂的数据分析、机器学习推理、科学计算…

科研课题设计全流程：从选题到成果落地的实战指南

科研课题设计全流程：从选题到成果落地的实战指南

2026/7/22 11:55:27

1. 课题设计全流程解析：从选题到成果落地的实战指南课题设计是科研工作者、高校师生以及企业研发人员日常工作中的核心环节。一个优秀的课题设计不仅决定了研究的方向和质量，更直接影响最终成果的学术价值和应用前景。作为在科研一线摸爬滚打多年的从业者…

数据分析师必学MySQL：从零构建电商销售分析实战

数据分析师必学MySQL：从零构建电商销售分析实战

2026/7/22 19:00:43

你是不是也遇到过这样的困惑：想学数据分析，看了很多Python、R语言的教程，结果发现第一步就被卡住了——数据从哪里来？怎么存？怎么查？怎么保证数据准确？很多数据分析教程都默认你已经有了一个干净…

HS2-HF Patch：3步实现HoneySelect2完美汉化与MOD整合

HS2-HF Patch：3步实现HoneySelect2完美汉化与MOD整合

2026/7/22 15:49:47

HS2-HF Patch：3步实现HoneySelect2完美汉化与MOD整合 【免费下载链接】HS2-HF_Patch Automatically translate, uncensor and update HoneySelect2! 项目地址: https://gitcode.com/gh_mirrors/hs/HS2-HF_Patch HS2-HF Patch是专为HoneySelect2玩家设计的一站…