React Native Android冷启动添加闪屏：点击通知重复触发闪屏问题

兄弟，我之前也碰到过一模一样的问题！这事儿大概率是React Native Android的单Activity架构，加上闪屏Activity的配置没跟上导致的，咱们一步步捋清楚解决：

本质上是因为Android单Activity架构下，点击通知时系统会尝试拉起主Activity，但如果闪屏Activity的任务栈处理、主Activity的启动模式没配置对，就会触发闪屏逻辑再次执行，导致已挂载的组件重新加载+闪屏重复显示。

1. 修正闪屏Activity的任务栈配置 #

打开AndroidManifest.xml，先给闪屏Activity加上android:noHistory="true"，确保它启动主Activity后直接销毁，不会留在任务栈里；同时把主Activity的启动模式设为singleTask，保证点击通知时复用已有实例，而非重新创建。

修改后的配置示例：

<!-- 闪屏Activity -->
<activity
    android:name=".SplashActivity"
    android:theme="@style/SplashTheme"
    android:noHistory="true"> <!-- 关键：不让闪屏留在任务栈 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

<!-- 主Activity -->
<activity
    android:name=".MainActivity"
    android:label="@string/app_name"
    android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
    android:launchMode="singleTask" <!-- 关键：单实例复用模式 -->
    android:windowSoftInputMode="adjustResize">
</activity>

另外，在闪屏Activity的onCreate方法里，启动主Activity后必须调用finish()，双重保障销毁闪屏页面：

// SplashActivity.java
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Intent intent = new Intent(this, MainActivity.class);
    startActivity(intent);
    finish(); // 启动主Activity后立即销毁自己
}

2. 调整通知PendingIntent的触发逻辑 #

创建通知的PendingIntent时，要设置正确的Flag，确保点击通知时唤醒已有的主Activity，而非重启它：

Intent intent = new Intent(context, MainActivity.class);
// 清除栈顶，复用已有的主Activity实例
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
// Android 12+必须加FLAG_IMMUTABLE，低版本用FLAG_UPDATE_CURRENT
PendingIntent pendingIntent = PendingIntent.getActivity(
    context,
    0,
    intent,
    PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
);

3. 限制RN端闪屏仅首次启动显示 #

如果你的RN代码里也做了闪屏逻辑，要通过AppState判断应用状态，只在首次启动时显示闪屏，避免后台唤醒时重复触发：

import { AppState, useState, useEffect } from 'react-native';
import SplashScreen from './components/SplashScreen';
import MainApp from './components/MainApp';

function App() {
  const [showSplash, setShowSplash] = useState(true);
  const [appState, setAppState] = useState(AppState.currentState);

  useEffect(() => {
    const appStateListener = AppState.addEventListener('change', nextState => {
      // 应用从后台回到前台时，直接隐藏闪屏
      if (appState.match(/inactive|background/) && nextState === 'active') {
        setShowSplash(false);
      }
      setAppState(nextState);
    });

    // 首次启动延迟隐藏闪屏
    const hideSplashTimer = setTimeout(() => {
      setShowSplash(false);
    }, 2000);

    return () => {
      appStateListener.remove();
      clearTimeout(hideSplashTimer);
    };
  }, [appState]);

  return showSplash ? <SplashScreen /> : <MainApp />;
}

export default App;

4. 排查第三方闪屏库的调用逻辑 #

如果你用了react-native-splash-screen这类库，要确保只在首次启动时调用显示方法，在MainActivity的onCreate里加判断：

// MainActivity.java
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 只有首次启动（savedInstanceState为null）时才显示闪屏
    if (savedInstanceState == null) {
        SplashScreen.show(this);
    }
}

核心就是两个关键点：

• 让闪屏Activity启动后立即销毁，不留在任务栈里
• 让主Activity以单实例模式运行，通知唤醒已有实例而非重启

按照这些步骤调整后，点击通知就不会再触发闪屏和组件重新加载了。

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