Flutter中如何通过Firebase通知无用户交互打开页面

问题核心分析 #

你当前的代码存在两个关键问题：

1. _firebaseMessagingBackgroundHandler是运行在独立Isolate中的后台函数，无法访问UI层的BuildContext，直接调用Navigator.pushNamed会失败。
2. 应用处于终止状态时，后台消息处理完成后无法直接触发UI跳转，必须通过应用启动时的逻辑来处理。

正确实现步骤 #

1. 调整后台消息处理函数

移除BuildContext参数，在后台仅做消息数据的存储或日志记录，不处理UI操作：

@pragma('vm:entry-point')
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp();
  
  if (message.data['key1'] == 'N7') {
    // 将跳转标记存储到本地（以SharedPreferences为例）
    final prefs = await SharedPreferences.getInstance();
    await prefs.setBool('needJumpToLogin', true);
  }
  
  print("Handling a background message: ${message.messageId}");
}

2. 应用启动时处理自动跳转

在main函数中初始化必要依赖，检查本地存储的跳转标记，指定初始路由：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // 初始化本地存储并读取跳转标记
  final prefs = await SharedPreferences.getInstance();
  final needJump = prefs.getBool('needJumpToLogin') ?? false;
  
  // 读取后清除标记，避免重复跳转
  if (needJump) {
    await prefs.remove('needJumpToLogin');
  }
  
  runApp(MyApp(needJumpToLogin: needJump));
}

class MyApp extends StatelessWidget {
  final bool needJumpToLogin;

  const MyApp({super.key, required this.needJumpToLogin});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      initialRoute: needJumpToLogin ? LoginScreen.screenId : '/',
      routes: {
        '/': (context) => const HomeScreen(),
        LoginScreen.screenId: (context) => const LoginScreen(),
      },
    );
  }
}

3. 处理后台/前台消息场景

针对应用在后台（未终止）或前台的情况，分别监听消息事件：

class HomeScreen extends StatefulWidget {
  const HomeScreen({super.key});

  @override
  State<HomeScreen> createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  @override
  void initState() {
    super.initState();
    
    // 应用在后台时，用户点击通知触发跳转
    FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
      if (message.data['key1'] == 'N7') {
        Navigator.pushNamed(context, LoginScreen.screenId);
      }
    });

    // 应用在前台时接收消息直接跳转
    FirebaseMessaging.onMessage.listen((RemoteMessage message) {
      if (message.data['key1'] == 'N7') {
        Navigator.pushNamed(context, LoginScreen.screenId);
      }
    });

    // 绑定后台消息处理函数
    FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Home')),
      body: const Center(child: Text('Home Screen')),
    );
  }
}

关键注意事项 #

• 后台消息处理函数必须保留@pragma('vm:entry-point')标记，防止Flutter编译时优化移除该函数。
• 确保发送的是数据消息（或通知+数据的混合消息），纯通知消息在应用终止时不会触发后台处理函数，仅由系统展示通知。
• 使用本地存储标记时，跳转完成后要及时清除标记，避免下次启动重复跳转。

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