Flutter 2.0升级空安全后Intl关联国际化代码迁移报错如何修复

项目依赖配置 #

• 项目已将Flutter SDK升级至2.0.0稳定版本，完成升级后已将绝大多数依赖切换为空安全兼容版本
• pubspec.yaml 中的环境约束与依赖配置如下：

environment:
  sdk: '>=2.12.0 <3.0.0'

dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter 
  cupertino_icons: ^0.1.3
  encrypt: ^4.1.0
  flutter_hooks: ^0.15.0
  flutter_map: ^0.11.0
  flutter_password_strength: ^0.1.5
  flutter_svg: ^0.18.0
  geolocator: ^7.0.1
  get: ^3.25.6
  get_it: ^6.0.0
  injectable: ^1.1.2
  local_auth: ^1.1.0
  moor_flutter: ^3.1.0
  provider: ^5.0.0
  shared_preferences: ^2.0.3
  supercharged: ^1.12.0
  intl: ^0.17.0

迁移过程中的报错 #

完成依赖版本更新后，执行 dart migrate 启动空安全迁移工具时，工具因检测到静态分析错误未能正常启动，共报出5条与Intl本地化相关的错误：

Analyzing project...
[---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------/]
5 analysis issues found:
  error • A value of type 'Null' can't be returned from the function '_findExact' because it has a return type of 'MessageLookupByLibrary' at lib/generated/intl/messages_all.dart:34:14 • (return_of_invalid_type)
  error • A value of type 'Null' can't be returned from the function '_findGeneratedMessagesFor' because it has a return type of 'MessageLookupByLibrary' at lib/generated/intl/messages_all.dart:65:36 • (return_of_invalid_type)
  error • Non-nullable instance field 'current' must be initialized at lib/generated/l10n.dart:16:3 • (not_initialized_non_nullable_instance_field)
  error • The non-nullable variable 'current' must be initialized at lib/generated/l10n.dart:18:12 • (not_initialized_non_nullable_variable)
  error • A value of type 'S?' can't be returned from the method 'of' because it has a return type of 'S' at lib/generated/l10n.dart:35:12 • (return_of_invalid_type)

The migration tool didn't start, due to analysis errors.

开发环境检测结果 #

执行 flutter doctor 得到的环境检测摘要如下，所有环境项均无异常：

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 2.0.0, on Linux, locale en_US.UTF-8)
[✓] Android toolchain - develop for Android devices (Android SDK version 30.0.0-rc1)
[✓] Chrome - develop for the web
[✓] Android Studio (version 4.0)
[✓] VS Code (version 1.53.2)
[✓] Connected device (2 available)

• No issues found!

报错原因与修复方案 #

以上报错均来自旧版本工具生成的非空安全兼容的本地化自动生成文件，并非Intl依赖本身的版本缺失问题，具体修复步骤如下：

• 清理旧的生成文件：删除 lib/generated 目录下所有旧版本地化生成文件，包括 l10n.dart、intl/messages_all.dart 及关联的本地化消息文件。
• 拉取最新依赖：执行 flutter pub get 同步空安全版本的依赖包。
• 重新生成空安全规范的本地化代码：
  • 使用intl_translation做本地化的项目，先将intl_translation升级至空安全兼容版本，再基于本地ARB源文件重新运行代码生成命令，生成适配空安全规则的messages文件与本地化代理文件。
  • 使用Flutter官方flutter_localizations工具链的项目，在pubspec.yaml中配置synthetic-package: false后，执行 flutter gen-l10n 命令重新生成本地化文件。
• 重新执行 dart migrate 启动空安全迁移工具，上述生成文件相关的报错会全部消除。不建议手动修改生成文件的可空标注，否则后续重新执行生成命令时会被自动覆盖，导致报错重复出现。

内容的提问来源于Stack Exchange，提问作者 Cyrus the Great