Flutter 开发遇到的坑 - 持续更新

本文用来记录开发中遇到的坑，以便下次快速解决问题，本文将长期更新，希望学习 Flutter 的同学，可以关注并在评论区提出自己的问题和解决办法，一起交流学习成长。

也请大佬看到指出其中解释或者解决方式不准确的地方。

升级 Flutter SDK

flutter upgrade

使用终端 cd 到之前下载的 Flutter 路径下，执行以上命令更新 Flutter SDK。 这个命令首先获取你的 Flutter 渠道可用的最新的 Flutter SDK 版本。接着这个命令更新你 app 依赖的每一个 package，到最新的兼容版本。更新完，需要使用dart pub cache repair命令将 Package 从缓存中清除并重新安装。

1、Could not build the application for the simulator.

Could not build the application for the simulator.
Error launching application on iPhone Xr.

这个是缓存问题导致，我在更换了 Flutter SDK 出现了此问题；

• 解决办法： 在终端清理 Flutter 缓存，并运行，具体的命令如下：

flutter clean
flutter run

如果以上办法还不能解决，可以删除 Xcode 的缓存，对应路径为： ~/Library/Developer/Xcode/DerivedData

这个错误是模糊的，建议在 Xcode 或者 Android Studio 中运行项目，会报出具体的原因，此处是用 Xcode 运行项目报错的内容，是因为没有找到 dart.html ，这个主要是库导入的有问题，请检查自己的库，我是因为多导入了dart:html导致的问题。

2、Avoid using web-only libraries outside Flutter web plugin packages.

找到 pubspec.yaml，注释掉 dependencies 中 flutter 的依赖就可以了 ，这是为了避免在Flutter Web 插件包之外使用纯web库。

3、使用 Android Studio 4+ 版本，plugins 无法加载出插件

将 HTTP Proxy 里面对应的位置设置为 plugins.jetbrains.com

4、Waiting for another flutter command to release the startup lock...

执行 flutter 终端命令的时候报错；

当项目异常关闭，或者 Android Studio用任务管理器强制关闭，下次启动就会出现上面的一行话， 此时需要打开 <flutter Dev 的路径>/bin/cache/lockfile，删除后重新执行终端代码就行了。 或者直接用下面的命令：rm ./flutter/bin/cache/lockfile。

5、Relaunch your application with the '-profile' argument

使用 Flutter DevTools ，打开性能调试报错；

因为没有打开 Profile 模式，所以报错，需要在终端使用flutter run --profile，或者在工具中运行 Profile 模式。

6、Exception: Profile mode is not supported for iPhone 12 Pro Max.

开启 Profile（ flutter run --profile ）的时候报错；

因为 Profile 模式只能在真机上运行，因为模拟器不能代表真实场景，所以不能在模拟器上运行。除了使用终端开启 Profile ，用其他开发工具也可以，例如 AS 的 Profile 也可以开启 Profile。

7、The method '*' was called on null.

因为使用的 * 是空，没有初始化导致，可以提前初始化 * 对象，再进行使用。

8、Run custom shell script '[CP-User] Run Flutter Build bb_ flutter_ module Script

因为 Native 和 Flutter 混编，没有更新 flutter 的库导致；

如果项目是 Native 和 Flutter 混编，在 flutter 代码里增加并使用了新的 库，另外一个人更新了代码，但是没有对 Flutter 执行 install 或者 upgrade，就会导致 flutter 的脚本终端报这个错误。

9、A non-null String must be provided to a Text widget

因为 Text widget 的内容不能为空，可以在没有内容的时候，赋值为空字符串 ?? ""

10、RenderFlex children have non-zero flex but incoming height constraints are unbounded.

这是因为 flex 的父 Widget 没有约束高度导致，可以给父 Widget 设置高度。

11、There are multiple observatory ports available.

在 Flutter 和 Native 混编的过程，使用 flutter attach 同步代码出现的错误。这是因为有多个端口，选择其中一个执行就可以了，一般选择不带数字的一个。

如果还不能解决，执行 flutter attach -v ，查看执行过程具体报错的位置，针对其进行解决。

12、The mDNS query for an attached iOS device failed.

需要禁用手机热点，并且在 Mac 设置 -> 网络 -> iPhone USB 下取消 Disable unless needed 的选中。

13、The default value of an optional parameter must be constant.

因为可选参数的默认值必须是常量，注意一些系统方法，底层有可能是用的函数实现，所以不能设置为默认值，可以加 const 创建常量。

• 对于 const 的使用，可以简单归纳成 3 种场景：

1、const 用在 = 左边：定义常量

2、const 用在 = 右边：创建常量

3、const 构造函数：创建常量

14、Try launching Xcode and selecting "Product > Run" to fix the problem: open ios/Runner.xcworkspace

iPhone 真机调试的时候报错，这是因为没有选择开发者账号，使用 Xcode 打开 Runner.xcworkspace，选择对应的开发者账号就可以。

15、platform exception(channel-error, unable to establish connection on channel., null, null)

因为使用了 Native 代码的插件，又没有注册导致的报错。

• iOS 可以在 FlutterEngine run 后，加入以下代码：

[GeneratedPluginRegistrant registerWithRegistry:self.flutterEngine];

要注意加入的顺序，否则有可能报其他错误，具体可以看官网示例：flutter.dev/docs/develo…

• Android 可以加以下代码：

GeneratedPluginRegistrant.registerWith(flutterEngine)

16、There are multiple observatory ports available.

There are multiple observatory ports available.

Rerun this command with one of the following passed in as the appId:
 ******

混编开发，使用 Xcode 真机运行项目，使用 flutter attach 命令出现的错误，因为端口问题，去掉终端或者电脑的翻墙，重新试试，如果还不可以，拔掉再插入手机，重新测试就可以了。

17、Incorrect use of ParentDataWidget.

Incorrect use of ParentDataWidget.

The ParentDataWidget Positioned(top: 9.0) wants to apply ParentData of type StackParentData to a RenderObject, which has been set up to accept ParentData of incompatible type FlexParentData.

Usually, this means that the Positioned widget has the wrong ancestor RenderObjectWidget. Typically, Positioned widgets are placed directly inside Stack widgets.
The offending Positioned is currently placed inside a Row widget.


The ownership chain for the RenderObject that received the incompatible parent data was:

  Semantics ← Image ← Container ← Positioned ← Visibility ← Row ← ColoredBox ← ConstrainedBox ← Container ← Row ← ⋯
When the exception was thrown, this was the stack: 


The following assertion was thrown while applying parent data.:
Incorrect use of ParentDataWidget.

这里造成警告的原因是在非 Stack 组件里面使用了 Positioned 组件；类似警告还可以出现在非 Row 或者 Column 组件中使用 Expanded。