Flutter集成FCM与本地通知后返回按钮失效问题求助

问题根源 #

返回键异常（直接退后台而非返回上一页）的核心原因是后台消息处理函数中错误尝试访问UI上下文执行导航操作：

• _handleBackgroundNotificationMessage作为Firebase后台消息回调，运行在独立的Isolate中，完全无法访问Flutter的UI上下文（包括App.materialKey.currentState）。
• 这种无效的导航调用会破坏Navigator的栈状态，导致实际导航栈中仅存在单个页面，触发返回键时直接退出应用。

FCM功能正常是因为消息接收逻辑未受影响，但导航相关的错误操作干扰了页面栈管理。

解决方案 #

1. 修正后台消息处理逻辑 #

移除后台消息回调中的导航代码，改为存储消息数据，待应用回到前台后再处理导航：

Future<void> _handleBackgroundNotificationMessage(RemoteMessage message) async {
  if (message.notification != null) return;
  // 仅存储消息数据，不执行UI操作
  SharedPreferences prefs = await SharedPreferences.getInstance();
  await prefs.setString('pending_route', '/appoinments');
}

2. 在应用初始化时处理待执行导航 #

在main函数中添加逻辑，检查是否有待处理的导航请求：

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseApi().initNotifications();
  SystemChrome.setSystemUIOverlayStyle(SystemUiOverlayStyle.dark);
  prefs = await SharedPreferences.getInstance();
  Constants.pref = await SharedPreferences.getInstance();

  // 检查并处理待执行导航
  String? pendingRoute = prefs.getString('pending_route');
  if (pendingRoute != null) {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      App.materialKey.currentState?.pushNamed(pendingRoute);
      prefs.remove('pending_route');
    });
  }

  runApp(MyApp());
}

3. 验证GlobalKey配置正确性 #

确保App.materialKey已正确绑定到MaterialApp：

class App {
  static final GlobalKey<NavigatorState> materialKey = GlobalKey<NavigatorState>();
}

// MyApp中的MaterialApp配置
MaterialApp(
  navigatorKey: App.materialKey,
  routes: {
    '/': (context) => HomePage(),
    '/appoinments': (context) => AppointmentsPage(),
  },
)

4. 移除冗余导航逻辑 #

检查onClickNotification等函数中是否有重复导航逻辑，避免多次推入相同页面导致栈混乱。

修改后的FirebaseApi核心代码 #

Future<void> _handleBackgroundNotificationMessage(RemoteMessage message) async {
  if (message.notification != null) return;
  // 存储待处理路由，而非直接导航
  SharedPreferences prefs = await SharedPreferences.getInstance();
  await prefs.setString('pending_route', '/appoinments');
}

class FirebaseApi {
  // ... 其他代码保持不变 ...

  void _handleMessage(RemoteMessage? message) {
    if (message == null) return;
    // 仅在前台时执行导航
    App.materialKey.currentState?.pushNamed('/appoinments');
  }

  // ... 其他代码保持不变 ...
}

额外检查项 #

• 执行flutter clean后重新编译，清除旧构建缓存
• 验证iOS滑动返回功能是否在MaterialApp中正常启用
• 确保初始页面已正确添加到导航栈，避免栈为空导致返回键直接退出应用

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