记录一个Flutter空安全升级问题

最新推荐文章于 2026-06-16 11:20:19 发布

原创最新推荐文章于 2026-06-16 11:20:19 发布 · 3.1k 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#flutter

Flutter 专栏收录该内容

7 篇文章

订阅专栏

文章讲述了作者遇到的奇特问题，子工程在空安全检测中正常，但主工程却报告子工程存在未启用空安全的依赖。深入分析发现，这可能是由于子工程的最低SDK版本设置低于2.12.0导致的。解决办法是更新依赖并确保所有依赖都支持null安全性。

最近碰到一个奇怪的问题

先来看个现象

工程结构

.
├── README.md
├── android
├── build
├── ios
├── lib
├── pubspec.lock
├── pubspec.yaml
├── subpackage
├── test
└── webview_demo.iml

子工程空安全检测正确✅

jiodg45@jiodg45s-MacBook-Pro subpackage % dart pub outdated --mode=null-safetyShowing dependencies that are currently not opted in to null-safety.
[✗] indicates versions without null safety support.
[✓] indicates versions opting in to null safety.

主工程检测却发现子工程出现空安全问题❌

jiodg45@jiodg45s-MacBook-Pro webview_demo % dart pub outdated --mode=null-safety
Showing dependencies that are currently not opted in to null-safety.
[✗] indicates versions without null safety support.
[✓] indicates versions opting in to null safety.

Package Name  Current        Upgradable     Resolvable     Latest         

direct dependencies:
subpackage    ✗0.0.1 (path)  ✗0.0.1 (path)  ✗0.0.1 (path)  ✗0.0.1 (path)

十分诡异,于是开启了--verbose查看详细日志,空安全检测具体命令dart pub outdated --mode=null-safety --verbose

可以看到空安全检测主要是对每个库的sdk版本与2.12.0进行比较

获取依赖,包含git/path/pub三个级别的依赖
其中工程外的pub依赖关系保存在/Users/jiodg45/.pub-cache/hosted/pub.dartlang.org/.cache/cupertino_icons-versions.json.,对应路径为$HOME/$PUB_CACHE/hosted/HOST_PUB_URL/.cache/{package_name}-versions, 此部分是从pub库上获取，通过json中的environment获取到sdk版本，用于后续比较
工程内的依赖关系保存在pubspec.lock文件中,git和path相关的一级依赖也会被添加到此仓库中,以来类型为dependency: transitive
这样仓库的所有的依赖关系可以从三个文件一次进行查找， pubspec.yaml->pubspec.lock->`` $H O M E /$ PUB_CACHE/hosted/HOST_PUB_URL/.cache/{package_name}-versions

对应的代码可以在pub库的outdated.dart中查看，省略后的关键代码如下,主要逻辑集中在supportsNullSafety,逐一查找package的dart sdkVersion,然后与2.12.0比较

https://github.com/dart-lang/pub/blob/master/lib/src/command/outdated.dart
-> OutdatedCommand

 @override
  Future<List<List<_MarkedVersionDetails>>> markVersionDetails(
      List<_PackageDetails> packages) async {
    final nullSafetyMap =
        await log.spinner('Computing null safety support', () async {
      /// Find all unique ids.
      ...
      return Map.fromEntries(
        await Future.wait(
          ids.map(
            (id) async => MapEntry(
                id,
                (await id.source.bind(cache).describe(id))
                    .languageVersion
                    .supportsNullSafety), 
    ...

所以当子工程的pubspec.yaml中sdkVersion指定的最低版本低于2.12.0时会报空安全检测异常. 因此在升级时一定要修改sdk的最低约束,防止误检.