执行flutter run报大量空类型错误，加--no-sound-null-safety正常如何解决

问题触发原因 #

flutter run --no-sound-null-safety是Dart提供的非健全空安全兼容模式，专门给还没完成空安全适配的旧项目做过渡用：这个模式下会跳过绝大多数运行时空类型校验，允许null值流入声明为非空的bool、int等类型变量，不会主动抛出类型不匹配错误，相当于把所有空值隐患全藏起来了，所以你之前跑的时候全程没报错。
直接执行flutter run时默认开启健全空安全，会对所有非空类型做严格的运行时校验，只要代码（包括你自己写的业务代码、引入的第三方依赖、状态管理类里的字段）里声明为非空的变量被赋值了null，就会直接抛出你看到的type 'Null' is not a subtype of type 'xxx'错误。报错指向Consumer<ConnectivityProvider>，说明核心问题出在这个网络连接状态管理的Provider类中，相关字段没有正确处理空值。

修复步骤 #

• 先定位问题点
  在项目根目录执行flutter analyze，静态扫描会直接标出绝大多数未处理的空安全问题，优先排查ConnectivityProvider类：检查类中所有非空的bool、int类型字段，比如网络连接状态标记、网络类型编码这类字段，是不是存在初始化时未赋值、接口/系统回调返回数据没做判空就直接赋值的情况。
• 按场景修复空值问题
  • 如果字段逻辑上允许为空，直接给类型加可空标记，比如bool? isConnected;、int? networkCode;，使用这类可空字段时要么提前判空，要么用??运算符设置默认值，比如bool validConnect = isConnected ?? false;
  • 如果字段逻辑上绝对不允许为空，只是初始化阶段暂时拿不到值，用late关键字修饰字段，注意必须保证字段在第一次被读取前完成赋值，否则会抛出延迟初始化错误。
  • 如果是接口返回、Map解析出来的dynamic类型值，赋值给非空字段前必须做判空和类型校验，不要直接用as强转成非空类型。
• 排查依赖兼容问题
  执行flutter pub outdated检查所有第三方依赖，把还没适配空安全的旧版依赖升级到支持空安全的稳定版本，很多空类型报错是旧版依赖在健全空安全模式下的兼容问题导致的。
• 临时过渡方案（不建议长期使用）
  如果短时间内来不及修复所有问题，可以在运行配置中保留--no-sound-null-safety参数，或者在对应dart文件开头加// @dart=2.9注解临时关闭单文件的空安全校验。但这只是临时掩盖问题，后续Flutter稳定版会逐步移除非健全空安全的支持，最终还是要完成全项目的空安全适配。

内容的提问来源于stack exchange，提问作者Jay