Flutter遇到的那些坑全面总结

Posted 2021-04-29 秦子帅

Flutter是一个新的跨平台开发的工具，博主也玩了一段时间，一步步的踩着坑摸石头过河，这其中受尽了各种各样的坑，各种谷歌，stackoverflow，Flutter官网等查资料，然而有些问题还是不能及时解决，于是就自己尝试着慢慢的摸索除了一些解决方案，在这里就系统的整理一下分享给大家，只希望大家给个鸡腿吃吃，今晚的晚餐就靠大家支持了！

一、Unable to find git in your PATH

错误如图所示：

【原因】未配置git环境变量或者配置不对。正确的应该是git根路径\bin。

二、git clone下载Flutter源码仓库，出现error: RPC failed; curl 18 transfer closed with outstanding read data remaining

【原因】

由于Http协议错误，当Clone的时候，因为curl的postBuffer默认值太小的原因，而项目可能本身比较大，所以下载失败。

【解决方案：】

打开git命令行 输入 git config –global http.postBuffer 524288000，然后可以输入 git config –list 查看刚才的设置是否生效。

说明： git config –global http.postBuffer 524288000 命令的意思：相当于把curl的postBuffer的值修改的大一些。524288000的单位是B，相当于500MB。

三、执行flutter命令的时候，360杀毒软件弹窗提示有病毒。

【解决方案：】

点击右下角“信任此文件”即可。建议执行flutter工程的时候，暂时关闭杀毒软件，如图所示。

四、执行flutter install命令安装apk到模拟器的时候报错，报错提示是：

【原因】由于使用了native libraries 。该native libraries 不支持当前的cpu的体系结构。我当前用的是x86的模拟器。

【解决方案】打开项目根目录/android/app/build.gradle，在android节点里面添加以下内容：

splits{
    abi {
        enable true
        reset()
        include 'x86', 'armeabi-v7a','x86_64'
        universalApk true
    }
}

具体的请看下图所示：

如果以上操作还不行就换一个arm的模拟器或者真机运行。如下图就是运行在arm模拟器上的示范操作：

五、执行flutter upgrade命令过程中出现的问题。

【解决方案】重启命令行，重新执行flutter upgrade命令，它会自动下载sdk需要的各种工具，这说明环境是没问题的，配置也是没问题的，网络也是OK的。如下图所示：

六、编译项目的过程中出现的版本兼容问题，如图所示。

【解决方案有以下几种方式】

只要看到错误信息含有 which doesn't match any version 这样的提示基本都可以使用以下解决方案：

 ● 1. 在项目的根路径的pubspec.lock文件和pubspec.yaml文件里面搜索，确保pubspec.lock文件的引入的第三方插件库的版本号和pubspec.yaml文件里的版本号一致。

 ● 2. 项目里面引入的第三方插件库版本和开发环境不匹配导致的兼容问题。建议把第三方插件库的源码下载下来，放到项目里面去，然后去修改插件库源码里依赖的Flutter和Dart版本配置信息即可。使用源码是最好的解决方式。

 ● 3. 在C盘的Flutter缓存目录，具体为：C:\Users\Administrator\AppData\Roaming\Pub\Cache\hosted，这里面默认是一个名为pub.dartlang.org的文件夹，我们现在查找看看有没有叫做pub.flutter-io.cn的文件夹，如果有，为了省事，建议把pub.dartlang.org的文件夹里面的文件全部拷贝到pub.flutter-io.cn文件夹里面就可以了。如果没有，就创建一个名为pub.flutter-io.cn的文件夹，然后再执行拷贝工作。（一般来讲，配置了国内镜像的话，就会有pub.flutter-io.cn文件夹）

七、flutter upgrade因为版本兼容问题导致升级失败。

【解决方案】这里面是因为flutter_tools包的兼容性问题导致的，可能是sdk版本兼容性问题，我们可以执行flutter upgrade升级一下Flutter再试试看，如果不行，就按第六条的去做。

八、Unsupported Android Studio version，意思是：Flutter插件不支持当前AS版本。

【原因】

当前的AS是3.2的版本。Flutter插件对AS3.2暂时还不兼容。

【解决方案】

使用3.0或者3.1版本的AS开发就OK了。

九、执行flutter upgrade命令更新Flutter时,出现SSL read: error:00000000:lib(0):func(0):reason(0), errno 10054

【解决方案】

打开git命令行输入 git config –global http.postBuffer524288000，然后可以输入 git config –list 查看刚才的设置是否生效。

十、使用flutter doctor命令出现的错误，这类错误可能有多种形式，它们都有一个共同的关键字 StartBitsTransferCOMException

我遇到的几个不同的错误示例图如下：

【解决方案】 原因有2个：

（1）BITS传输服务未开启：

计算机 --> 右键 管理 --> 服务和应用程序里面，点击服务，然后如下图所示：

然后选中图中标记的这个，右键点击属性，然后改成自动，确定。如下图所示：

（2）没有设置国内镜像：

如果你在国内使用 Flutter，那么你可能需要找一个与官方同步的可信的镜像站点，帮助你的 Flutter 命令行工具到该镜像站点下载其所需的资源。你需要为此设置两个环境变量：PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL，然后再运行 Flutter 命令行工具。

需要添加国内镜像到环境变量中。具体如下：

FLUTTER_STORAGE_BASE_URL: https://storage.flutter-io.cn
PUB_HOSTED_URL: https://pub.flutter-io.cn

如下图所示：如果还出现下载错误 建议重启电脑再试试看。

十一、update_dart_sdk.ps1文件里面出错，有多种错误表现形式，如下面3个图所示。

【解决方案】 

建议删除Flutter根路径/bin/cache文件夹，然后重新执行flutter doctor命令，Flutter根路径/bin/cache文件夹所在位置如下图所示：

---END---