Flutter 网络层为什么不能直接用 Dio？

网罗开发小红书、快手、视频号同名大家好我是展菲目前在上市企业从事人工智能项目研发管理工作平时热衷于分享各种编程领域的软硬技能知识以及前沿技术包括iOS、前端、Harmony OS、Java、Python等方向。在移动端开发、鸿蒙开发、物联网、嵌入式、云原生、开源等领域有深厚造诣。图书作者《ESP32-C3 物联网工程开发实战》图书作者《SwiftUI 入门进阶与实战》超级个体COC上海社区主理人特约讲师大学讲师谷歌亚马逊分享嘉宾科技博主华为HDE/HDG我的博客内容涵盖广泛主要分享技术教程、Bug解决方案、开发工具使用、前沿科技资讯、产品评测与使用体验。我特别关注云服务产品评测、AI 产品对比、开发板性能测试以及技术报告同时也会提供产品优缺点分析、横向对比并分享技术沙龙与行业大会的参会体验。我的目标是为读者提供有深度、有实用价值的技术洞察与分析。展菲您的前沿技术领航员 大家好我是展菲 全网搜索“展菲”即可纵览我在各大平台的知识足迹。 公众号“Swift社区”每周定时推送干货满满的技术长文从新兴框架的剖析到运维实战的复盘助您技术进阶之路畅通无阻。 微信端添加好友“fzhanfei”与我直接交流不管是项目瓶颈的求助还是行业趋势的探讨随时畅所欲言。 最新动态2025 年 3 月 17 日快来加入技术社区一起挖掘技术的无限潜能携手迈向数字化新征程文章目录引言Dio 本质上只是一个请求工具项目变大后最常见的问题接口地址到处都是错误处理不统一Token 刷新逻辑混乱一个更合理的网络层结构ApiClient统一管理 DioApiService封装业务接口ApiError统一错误处理Dio 的拦截器是网络层的关键一个真实项目的网络调用方式总结引言很多 Flutter 项目在刚开始时网络请求往往写得非常简单finaldioDio();finalresponseawaitdio.get(https://api.example.com/user,);print(response.data);功能能跑数据也能拿到看起来完全没有问题。但当项目逐渐变大你会发现网络相关的代码开始变得越来越混乱每个页面都在写请求逻辑错误处理方式不统一Token 刷新逻辑到处都是接口地址分散在各个文件这时候很多团队才意识到一个问题Dio 只是一个 HTTP 客户端而不是完整的网络层。如果直接在项目里到处使用 Dio后期维护成本会非常高。Dio 本质上只是一个请求工具先说一个很多人容易忽略的事实Dio 的职责其实非常简单发送 HTTP 请求处理请求参数返回响应数据它解决的是“通信层”的问题例如dio.get()dio.post()dio.put()但在真实项目中网络层需要处理的事情远远不止这些例如API 地址管理Token 管理请求日志错误处理数据转换这些能力如果全部直接写在页面里很快就会变成一团乱。项目变大后最常见的问题很多 Flutter 项目在 20 页面之后会出现几个非常典型的问题。接口地址到处都是例如dio.get(/user/profile);dio.get(/order/list);dio.get(/order/detail);这些地址往往直接写在页面里。当后端接口调整时你需要在整个项目里搜索字符串。这不仅容易漏改也会增加维护成本。错误处理不统一不同开发者写代码时处理错误的方式往往不一样。例如try{finalresponseawaitdio.get(/user);}catch(e){print(e);}有的人打印日志有的人弹 Toast还有的人直接忽略错误。结果就是用户体验不一致调试也很困难。Token 刷新逻辑混乱很多 App 都需要登录认证例如请求头需要带 TokenToken 过期需要刷新如果没有统一的网络层代码可能会变成这样dio.options.headers[Authorization]token;这段代码可能出现在几十个地方。一旦 Token 刷新逻辑改变就需要大面积修改代码。一个更合理的网络层结构比较成熟的 Flutter 项目通常会把网络层分成几部分。例如network/ ├─ api_client.dart ├─ api_service.dart ├─ api_error.dart ├─ api_response.dart每一层职责不同。ApiClient统一管理 Dio这一层主要负责创建 Dio 实例设置 BaseUrl设置超时注册拦截器例如classApiClient{finalDiodio;ApiClient():dioDio(BaseOptions(baseUrl:https://api.example.com,connectTimeout:Duration(seconds:10),receiveTimeout:Duration(seconds:10),),){dio.interceptors.add(LogInterceptor());}}这样项目里就不会到处创建 Dio 实例。ApiService封装业务接口这一层负责定义具体接口例如classUserService{finalDiodio;UserService(this.dio);FutureUsergetUserProfile()async{finalresponseawaitdio.get(/user/profile);returnUser.fromJson(response.data);}}这样页面代码就会变得非常干净finaluserawaituserService.getUserProfile();ApiError统一错误处理很多成熟项目会定义统一错误结构例如classApiError{finalint code;finalStringmessage;ApiError(this.code,this.message);}在拦截器中统一处理dio.interceptors.add(InterceptorsWrapper(onError:(error,handler){// 统一处理网络错误handler.next(error);},),);这样页面层就不需要处理复杂逻辑。Dio 的拦截器是网络层的关键很多开发者使用 Dio 时只用到了get和post。但实际上 Dio 最强大的能力是Interceptor。拦截器可以做很多事情自动添加 Token请求日志统一错误处理自动刷新 Token例如dio.interceptors.add(InterceptorsWrapper(onRequest:(options,handler){options.headers[Authorization]token;returnhandler.next(options);},),);这样所有请求都会自动带上 Token页面代码完全不用关心。一个真实项目的网络调用方式当网络层设计完成后页面代码通常会非常简单。例如classUserViewModel{finalUserServiceservice;UserViewModel(this.service);FutureUserloadUser()async{returnawaitservice.getUserProfile();}}页面只需要调用finaluserawaitviewModel.loadUser();网络细节全部被隐藏在底层。总结很多 Flutter 项目一开始直接使用 Dio是因为开发速度快项目规模小逻辑简单但当项目逐渐变大后网络请求就不再只是“发一个 HTTP 请求”这么简单。如果没有统一的网络层你很快会遇到接口管理混乱错误处理不统一Token 逻辑分散维护成本不断增加Dio 本身是一个非常优秀的工具但它只是网络层的一部分。真正成熟的 Flutter 项目通常会在 Dio 之上再封装一层统一接口管理统一错误处理统一日志统一认证逻辑当网络层结构设计合理之后你会发现页面代码变得非常干净而后期维护也会轻松很多。网络层看起来只是一个小模块但在长期维护的项目中它往往是最能体现工程质量的一部分。