尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
避坑清单:用WanAndroid-Flutter学习Flutter必碰的7个常见问题与解决方案
避坑清单用WanAndroid-Flutter学习Flutter必碰的7个常见问题与解决方案【免费下载链接】WanAndroid-FlutterFlutter版本 WanAndroid客户端 适合Flutter入门学习 被张鸿洋微信公众号推荐为优质Flutter开源项目啦项目地址: https://gitcode.com/gh_mirrors/wa/WanAndroid-FlutterWanAndroid-Flutter 是一款基于 Flutter 开发的 WanAndroid 客户端功能覆盖文章列表、知识体系、搜索、收藏和 WebView 详情页代码简洁、结构清晰被张鸿洋微信公众号推荐为优质 Flutter 开源项目非常适合新手作为 Flutter 入门学习的第一个实战项目。本文整理了在该项目上手与学习过程中最常踩的 7 个坑并逐一给出解决方案。快速开始一键获取项目并跑起来在开始避坑前先获取代码git clone https://gitcode.com/gh_mirrors/wa/WanAndroid-Flutter flutter pub get flutter run项目整体目录非常友好页面集中在 lib/pages/网络层在 lib/http/数据模型在 lib/model/入口是 lib/main.dart。先跑通项目后面的坑你才会似曾相识。坑 1Dart SDK 版本冲突——pubspec.yaml 的约束拦住了新环境现象用较新的 Flutter 环境执行flutter pub get时报The current Dart SDK version is 3.x.x之类的版本不满足错误。原因项目 pubspec.yaml 中写的是sdk: 2.12.0 3.0.0而新版 Flutter 已捆绑 Dart 3。✅解决把 SDK 约束放宽为sdk: 2.12.0 4.0.0本项目已完成空安全适配兼容 Dart 3 无压力再重新flutter pub get。坑 2依赖包版本过旧导致 pub get 失败现象pub get报版本冲突常见嫌疑人是dio: 4.0.4、webview_flutter: ^2.0.10、shared_preferences: ^2.0.6这些偏旧的固定版本。原因老项目锁定的依赖版本与新 SDK 传递依赖不兼容。✅解决执行flutter pub upgrade逐步升级升级webview_flutter到 v3 时注意 API 有变化如WebView构造方式对照 lib/pages/article_detail_page.dart 调整即可改动量很小。坑 3Android 9 禁止 HTTP 明文请求网页打不开现象真机运行后WebView 里的部分内容或 http 接口请求被拦截页面空白。原因Android 9API 28起默认禁止明文 HTTP 流量。✅解决项目已给出标准做法——在 android/app/src/main/res/xml/network_security_config.xml 中设置cleartextTrafficPermittedtrue并在 AndroidManifest.xml 中引用该配置。学习时可直接照抄这套配置。坑 4WebView 加载网页的 JS 与跳转拦截问题现象文章详情加载异常或页内链接被文章站的乱七八糟的跳转带偏。原因WebView 默认不放开 JS且未拦截非 http(s) 跳转。✅解决参考 lib/pages/article_detail_page.dart打开javascriptMode: JavascriptMode.unrestricted并用navigationDelegate只放行http:/https:开头的跳转。这是 Flutter WebView 插件使用的经典姿势。坑 5底部 Tab 来回切换页面状态复活不了现象首页 → 发现 → 首页列表滚动位置丢失、重复请求数据。原因普通switch写法会销毁再重建页面。✅解决看 lib/pages/home_page.dart用IndexedStack同时挂载三个页面并只切换 index状态自然保留。这是 Flutter 底部导航保持状态的标准方案建议直接掌握。坑 6轮播 Banner 的 TabController 报错或内存泄漏现象运行期报A Ticker was activated. Another ticker is still active或控制台警告未释放资源。原因TabController需要TickerProvider作为 vsync且必须在dispose中释放。✅解决对照 lib/widget/slide_view.dartState 混入SingleTickerProviderStateMixin在initState创建控制器在dispose中调用tabController.dispose()。三步缺一不可Banner 轮播就稳了。坑 7登录 Cookie 丢了收藏功能总提示未登录现象登录后杀进程重启收藏、点赞等需要登录态的功能全部失效。原因服务端用 Cookie 维持会话客户端没有持久化 Cookie。✅解决项目用dio_cookie_managerpath_provider实现了 Cookie 持久化配置见 lib/http/app_dio.dart只要传入cookiesPath就会自动挂载CookieManager。API 地址集中在 lib/http/app_urls.dart接口结构一目了然。总结7 个坑一张表#问题关键文件核心解法1Dart SDK 版本冲突pubspec.yaml放宽 SDK 约束到4.0.02依赖版本过旧pubspec.yamlflutter pub upgrade逐个升级3HTTP 明文被拦截network_security_config.xml开启 cleartextTrafficPermitted4WebView JS/跳转问题article_detail_page.dart放开 JS navigationDelegate 拦截5Tab 切换丢状态home_page.dartIndexedStack保活6Banner 控制器报错slide_view.dartTickerProvider dispose7Cookie 登录态丢失app_dio.dartdio_cookie_manager 持久化项目作者也在 README.md 中列出了下拉刷新统一封装、空数据/错误页统一处理等待解决问题正好是学完这 7 个坑之后可以动手进阶的方向。把这份避坑清单存下来你的 Flutter 入门之路会顺畅很多 【免费下载链接】WanAndroid-FlutterFlutter版本 WanAndroid客户端 适合Flutter入门学习 被张鸿洋微信公众号推荐为优质Flutter开源项目啦项目地址: https://gitcode.com/gh_mirrors/wa/WanAndroid-Flutter创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

电脑多开软件哪个好用 电脑多开软件推荐

电脑多开软件哪个好用 电脑多开软件推荐

不少用户都会反复纠结电脑多开软件哪个好用,试过多款工具后,常会遇到画质缩水、延迟偏高、设备连接受限等问题。职场人需要同时登录多个业务账号,并行处理表格、对接消息。电脑多开软件哪个好用?综合实测对比各类工具,…

📅 2026/11/14 16:41:40
PingFangSC 如何选对字重:3 步装好苹果方中文字体

PingFangSC 如何选对字重:3 步装好苹果方中文字体

PingFangSC 如何选对字重:3 步装好苹果方中文字体 【免费下载链接】PingFangSC PingFangSC字体包文件、苹果平方字体文件,包含ttf和woff2格式 项目地址: https://gitcode.com/gh_mirrors/pi/PingFangSC PingFangSC 是一个苹果方字体(中…

📅 2026/11/15 15:57:33
BlobRunner --jit 选项深度揭秘:如何用一个访问违规异常秒唤 JIT 调试器

BlobRunner --jit 选项深度揭秘:如何用一个访问违规异常秒唤 JIT 调试器

BlobRunner --jit 选项深度揭秘:如何用一个访问违规异常秒唤 JIT 调试器 【免费下载链接】BlobRunner Quickly debug shellcode extracted during malware analysis 项目地址: https://gitcode.com/gh_mirrors/bl/BlobRunner BlobRunner 是一款专为恶意软件分…

📅 2026/11/15 8:24:11
MORE NEWS

更多资讯

📰

江阴哪里报名电工证?学历不高怕报不上名?郑州报考避坑指南来了

江阴哪里报名电工证?学历不高怕报不上名?郑州报考避坑指南来了 你是不是也担心学历不高,连个电工证都报不上?别急,今天就给你讲明白, 江阴哪里报名电工证 ,还有郑州报考避坑指南,帮你理清思路,顺利拿到手。 电工证到底值不值得考?…

📰

为什么是电工证含金量高?实操考试心里没底怕挂科怎么破

为什么是电工证含金量高?实操考试心里没底怕挂科怎么破 实操考试心里没底怕挂科,这是大多数准备考电工证的朋友最真实的心理写照。电工证作为特种作业操作证中含金量最高的一种,不仅涉及范围广,而且就业面广,但正因为如此,很多人在备考时感到焦虑,尤其…

📰

电工证有ic卡的吗 2026河南最新政策你必须知道

电工证有ic卡的吗 2026河南最新政策你必须知道 你现在正站在找工作的十字路口,手里缺一张电工证,单位不招你,项目进不了,这事儿急得你睡不着觉。2026年河南最新政策对电工证的要求更严了, 电工证有ic卡的吗…

📰

高级电工证是干嘛的官方回应说学历不高也能考

高级电工证是干嘛的官方回应说学历不高也能考 你是不是担心自己学历不高,报名高级电工证会被拒?官方回应来了,河南政务服务网明确说明,只要符合岗位要求,学历并不是报名的唯一门槛。下面我来给你详细拆解高级电工证是干嘛的,以及河南房建工程从业者怎么…

📰

广东省应急电工证查询多久拿证才靠谱

广东省应急电工证查询多久拿证才靠谱 你不知道去哪报名怕被中介坑?广东省应急电工证查询流程复杂,拿证时间又不透明,让很多电工从业者苦不堪言。别急,这期内容带你避开所有坑,从报名到拿证一清二楚,还告诉你 多久拿证 才靠谱。 电工证报名常见误区…

📰

长春电工证过期年审保姆级教程:别让证书“失效”耽误你工作

长春电工证过期年审保姆级教程:别让证书“失效”耽误你工作 证书过期了不知道怎么复审延期?别慌,这期内容就帮你把【长春电工证过期年审】流程讲透,从准备材料到考试安排,一步不落地告诉你怎么做。如果你正在担心自己的电工证过期了,那这篇【保姆级教程…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬