Flutter 3.22+ 版本中，telephony 包在 Release 模式下因后台回调机制变更导致空指针异常崩溃；根本原因在于 Flutter 新版 AOT 编译移除了部分反射元数据，使 FlutterCallbackInformation 初始化失败。降级至稳定兼容版本可快速修复。

flutter 3.22+ 版本中，`telephony` 包在 release 模式下因后台回调机制变更导致空指针异常崩溃；根本原因在于 flutter 新版 aot 编译移除了部分反射元数据，使 `fluttercallbackinformation` 初始化失败。降级至稳定兼容版本可快速修复。

在使用 telephony（v0.3.0+）监听短信时，许多开发者发现：Debug 模式运行正常，但 Release 构建后应用在收到 SMS 瞬间崩溃，并抛出类似以下关键错误：

java.lang.NullPointerException: Attempt to read from field 'java.lang.String io.flutter.view.FlutterCallbackInformation.callbackLibraryPath' on a null object reference

该异常并非权限或 AndroidManifest 配置问题（即使已正确声明 RECEIVE_SMS、READ_SMS 及 声明），而是源于 Flutter 引擎底层变更：自 Flutter 3.22 起，AOT 编译器对 @pragma('vm:entry-point') 的处理逻辑收紧，且 FlutterCallbackInformation 在 Release 模式下无法被正确序列化/反序列化，导致 IncomingSmsReceiver 在尝试调用 Dart 后台回调时访问了空引用。

✅ 经验证的解决方案（推荐顺序）：

1. 优先降级 Flutter SDK 至稳定兼容版本
   当前已确认稳定工作的版本为：

   flutter downgrade 3.19.6  # 最新稳定兼容版（截至 2024 年中）

   ⚠️ 注意：执行 flutter downgrade 后需清理构建缓存：

   flutter clean && flutter pub get
   cd android && ./gradlew clean && cd ..

2. 若必须使用新版 Flutter，请临时规避 telephony 的后台回调机制
   改用前台监听（仅适用于用户处于应用内场景）：

   final telephony = Telephony.instance;
   await telephony.initialize();
   telephony.listenToSms(
     onSmsReceived: (SmsMessage message) {
       debugPrint('SMS received: ${message.body}');
       // ✅ 此回调在主线程执行，不依赖 FlutterCallbackInformation
     },
   );

   并在 AndroidManifest.xml 中 移除 IncomingSmsReceiver 声明（避免系统触发崩溃的广播接收器）。

3. 长期建议：迁移到更现代的替代方案
   telephony 包已长期未维护（最后更新于 2022 年）。推荐转向：

   • sms_maintained（社区维护分支，适配较新 Flutter）
   • 或使用平台通道 + 原生 Android SmsRetrieverClient（更安全、无需敏感权限）

? 重要提醒：

• @pragma('vm:entry-point') 仅标记 Dart 函数不被混淆，不能修复 FlutterCallbackInformation 初始化失败的根本问题；
• Android 10+ 设备上，READ_SMS 权限已被严格限制，建议改用 SmsRetrieverApi（免权限获取一次性验证码）；
• 所有 SMS 相关功能必须在 android/app/src/main/AndroidManifest.xml 中显式声明 android:exported="true"（Android 12+ 要求）。

综上，该崩溃是 Flutter 版本演进与老旧插件不兼容的典型表现。短期通过降级 SDK 快速止损，中长期务必切换至活跃维护的通信插件或原生集成方案，以保障稳定性与合规性。