Expo React Native后台通知点击跳转ChatScreen失效求助

核心原因 #

应用处于关闭状态时，点击通知启动应用，此时导航栈尚未初始化，你在TaskManager中直接调用NewNavigate.navigate完全无效——因为导航实例还未创建。而应用运行时导航实例已存在，所以responseListener能正常工作。

解决方案 #

需要在应用启动阶段获取启动通知的信息，等导航容器就绪后再执行跳转操作，具体步骤如下：

1. 在根组件中获取初始通知 #

在App根组件（而非Home组件）中，使用Notifications.getInitialNotificationAsync()获取应用从关闭状态被通知启动时的通知数据：

import { useEffect, useState } from 'react';
import { NavigationContainer, createNavigationContainerRef } from '@react-navigation/native';
import { createNativeStackNavigator } from '@react-navigation/native-stack';
import * as Notifications from 'expo-notifications';
import ChatScreen from './path/to/ChatScreen';
import Home from './path/to/Home';

const Stack = createNativeStackNavigator();
// 创建全局导航引用，方便在导航容器就绪后调用跳转
export const navigationRef = createNavigationContainerRef();

export default function App() {
  const [initialNotification, setInitialNotification] = useState(null);

  useEffect(() => {
    async function getInitialNotification() {
      const notificationResponse = await Notifications.getInitialNotificationAsync();
      if (notificationResponse) {
        setInitialNotification(notificationResponse);
      }
    }

    getInitialNotification();
  }, []);

  return (
    <NavigationContainer
      ref={navigationRef}
      // 导航容器就绪后，检查初始通知并执行跳转
      onReady={() => {
        if (initialNotification) {
          navigationRef.current.navigate('ChatScreen', {
            nexists: initialNotification.notification.request.identifier,
          });
        }
      }}
    >
      <Stack.Navigator initialRouteName="Home">
        <Stack.Screen name="Home" component={Home} />
        <Stack.Screen name="ChatScreen" component={ChatScreen} />
      </Stack.Navigator>
    </NavigationContainer>
  );
}

2. 移除无效的后台任务跳转逻辑 #

你的BACKGROUND_NOTIFICATION_TASK中尝试跳转的代码在应用关闭时无法工作，因为导航实例不存在。可以修改后台任务处理其他逻辑（比如更新应用角标）：

const BACKGROUND_NOTIFICATION_TASK = "BACKGROUND-NOTIFICATION-TASK";

TaskManager.defineTask(
  BACKGROUND_NOTIFICATION_TASK,
  async ({ data, error, executionInfo }) => {
    if (error) {
      console.log("Error in background task:", error);
      return;
    }
    // 处理后台接收通知的逻辑，比如更新角标
    await Notifications.setBadgeCountAsync(1);
  }
);

// 确保任务注册在组件外部或根组件中
Notifications.registerTaskAsync(BACKGROUND_NOTIFICATION_TASK);

3. 保留应用运行时的响应监听 #

Home组件中的responseListener可以保留，用于处理应用前台/后台运行时点击通知的跳转：

// Home组件中的useEffect保留这部分逻辑
responseListener.current = Notifications.addNotificationResponseReceivedListener((response) => {
  navigate("ChatScreen", {
    nexists: response.notification.request.identifier,
  });
});

4. 确保推送通知Payload包含必要数据 #

发送推送通知时，要确保payload中包含data字段（即使是空对象），这样Expo才能正确传递通知数据到getInitialNotificationAsync：

{
  "to": "EXPO_PUSH_TOKEN",
  "sound": "default",
  "title": "新消息",
  "body": "你有一条新的聊天消息",
  "data": { "screen": "ChatScreen" } // 可选，用于明确跳转目标
}

关键注意事项 #

• getInitialNotificationAsync()只会在应用从关闭状态被通知启动时返回数据，应用后台运行时点击通知的场景，交给addNotificationResponseReceivedListener处理。
• 必须使用物理设备测试，模拟器无法正确处理关闭状态下的通知跳转逻辑。

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