React Native应用TestFlight首启崩溃，报错TypeError: e.props.onChangeToken未定义

根据你描述的情况——本地运行正常但TestFlight首次启动崩溃、重启后恢复，结合错误信息TypeError: undefined is not an object (evaluating 'e.props.onChangeToken')，以及你提到的FCM操作流程，这个问题基本可以锁定在FCM Token回调的初始化时机或组件props传递上。下面是几个经过验证的排查和解决方向：

1. 检查FCM Token监听的初始化时机 #

首次启动时，App的初始化流程还在进行，如果你在组件挂载完成前就注册了FCM的Token变化监听（比如onTokenRefresh），可能会导致回调触发时，接收onChangeToken的组件还没准备好，props自然是undefined。

解决方法：
确保FCM的Token监听是在组件完全挂载后才注册：

• 类组件：把监听逻辑放在componentDidMount中
• 函数组件：用useEffect并传入空依赖数组[]，确保只执行一次

// 类组件示例
componentDidMount() {
  this.tokenRefreshListener = FCM.onTokenRefresh(token => {
    // 先判断onChangeToken是否存在再调用
    if (this.props.onChangeToken) {
      this.props.onChangeToken(token);
    }
  });
}

componentWillUnmount() {
  // 记得移除监听避免内存泄漏
  this.tokenRefreshListener.remove();
}

2. 给onChangeToken加防御性判断 #

错误直接指向e.props.onChangeToken未定义，说明在调用这个回调时，对应的组件props没有正确传递。你可以在调用前先做存在性检查，避免崩溃。

解决方法：
在所有调用onChangeToken的地方，先判断是否存在：

// 比如在处理Token的组件内部
if (typeof this.props.onChangeToken === 'function') {
  this.props.onChangeToken(newToken);
}

同时检查使用该组件的父组件，确保始终传递了onChangeToken回调，或者在组件内部设置默认值：

// 类组件设置默认props
static defaultProps = {
  onChangeToken: () => {}
};

// 函数组件设置默认props
const FCMTokenHandler = ({ onChangeToken = () => {} }) => {
  // ...
}

3. 延迟FCM操作到App完全活跃后 #

TestFlight环境下，App首次启动的初始化速度可能比本地慢，如果你在App启动初期就调用getInitialNotification、requestPermissions，可能会触发FCM内部的回调，而此时相关组件还没渲染完成。

解决方法：
借助AppState监听App进入活跃状态后，再执行FCM相关操作：

import { AppState } from 'react-native';

componentDidMount() {
  AppState.addEventListener('change', this.handleAppStateChange);
}

handleAppStateChange = (nextState) => {
  if (nextState === 'active') {
    // 执行FCM操作
    FCM.getInitialNotification().then(notif => {
      this.setState({ initNotif: notif });
    });
    FCM.requestPermissions({ badge: false, sound: true, alert: true });
    // 移除监听，避免每次App回到前台都重复执行
    AppState.removeEventListener('change', this.handleAppStateChange);
  }
}

4. 排查FCM依赖和配置问题 #

旧版本的FCM库可能存在Release/TestFlight环境下的bug，另外iOS端的配置也可能影响FCM的初始化：

• 升级你的FCM依赖到最新稳定版（如果用的是react-native-firebase，确保@react-native-firebase/messaging是最新版）
• 检查GoogleService-Info.plist是否正确添加到Xcode的TestFlight打包目标中（Target -> Build Phases -> Copy Bundle Resources）
• 确认Xcode Capabilities中的Push Notifications和Background Modes（勾选Remote notifications）已开启

5. 模拟TestFlight环境调试 #

为了更精准定位问题，可以直接打包Release版本安装到真机，而不是通过TestFlight，这样可以用Xcode查看真机日志：

1. 在Xcode中选择Product -> Archive，打包完成后选择Distribute App -> Development，然后安装到真机
2. 打开Xcode的Window -> Devices and Simulators，选中你的真机，查看Console日志
3. 在FCM相关代码中添加日志，比如：

console.log('[FCM] Starting getInitialNotification');
FCM.getInitialNotification().then(notif => {
  console.log('[FCM] Initial notification:', notif);
  this.setState({ initNotif: notif });
}).catch(err => console.error('[FCM] getInitialNotification error:', err));

通过日志可以看到FCM操作的执行顺序，以及是否在组件准备好前触发了回调。

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