React Native Android端应用如何实现程序化重启？

阿华AIGC实验室

2026-4-14

我太懂这种在生产环境踩坑的感觉了——网上搜出来的好多重启方案，在debug模式下跑的好好的，一到生产环境就直接失效，真的头疼。下面给你两个经过验证、在生产环境稳定可用的实现方式，你可以根据自己的项目情况选：

方法一：自定义Android原生模块（最可靠，无依赖）

这个方法直接通过原生Android代码调用系统启动逻辑，完全绕开React Native的限制，生产环境100%可用：

第一步，创建Android原生模块类
在你的项目android/app/src/main/java/[你的包名]/modules/目录下（如果modules目录不存在就新建一个），新建RestartModule.java文件，代码如下：

package com.yourappname.modules; // 替换成你自己的包名

import android.app.Activity;
import android.content.Intent;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;

public class RestartModule extends ReactContextBaseJavaModule {

    public RestartModule(ReactApplicationContext reactContext) {
        super(reactContext);
    }

    @Override
    public String getName() {
        // 这个名字要和RN端调用的模块名一致
        return "RestartModule";
    }

    @ReactMethod
    public void restartApp() {
        Activity currentActivity = getCurrentActivity();
        if (currentActivity != null) {
            // 获取应用的启动Intent
            Intent intent = currentActivity.getPackageManager()
                    .getLaunchIntentForPackage(currentActivity.getPackageName());
            if (intent != null) {
                // 清除Activity栈，确保重启后是全新的实例
                intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_NEW_TASK);
                currentActivity.startActivity(intent);
                currentActivity.finish();
                // 杀死当前进程，彻底重启
                android.os.Process.killProcess(android.os.Process.myPid());
                System.exit(0);
            }
        }
    }
}

第二步，创建Package类注册模块
同样在modules目录下，新建RestartPackage.java文件：

package com.yourappname.modules; // 替换成你自己的包名

import com.facebook.react.ReactPackage;
import com.facebook.react.bridge.NativeModule;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.uimanager.ViewManager;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class RestartPackage implements ReactPackage {

    @Override
    public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
        List<NativeModule> modules = new ArrayList<>();
        modules.add(new RestartModule(reactContext));
        return modules;
    }

    @Override
    public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
        return Collections.emptyList();
    }
}

第三步，在MainApplication中注册Package
打开android/app/src/main/java/[你的包名]/MainApplication.java，找到getPackages方法，添加自定义的Package：

@Override
protected List<ReactPackage> getPackages() {
    @SuppressWarnings("UnnecessaryLocalVariable")
    List<ReactPackage> packages = new PackageList(this).getPackages();
    // 加入我们的RestartPackage
    packages.add(new RestartPackage());
    return packages;
}

第四步，RN端调用重启方法
在RN项目中创建一个工具函数，比如utils/restart.js：

import { NativeModules } from 'react-native';

// 注意这里的模块名要和原生模块中getName()返回的一致
const { RestartModule } = NativeModules;

export const restartApp = () => {
    // 调用原生重启方法
    RestartModule.restartApp();
};

之后在需要重启的地方直接调用restartApp()就可以了，比如设置更新完成后：

import { restartApp } from './utils/restart';

// 比如用户点击确认更新完成后
const handleUpdateComplete = () => {
    // 做一些清理工作后
    restartApp();
};

方法二：使用成熟的第三方库（快速实现）

如果你不想写原生代码，可以用react-native-restart这个库，它已经封装好了原生逻辑，只要版本适配正确，生产环境也能用：

首先安装库（选最新稳定版）：
```
npm install react-native-restart --save
# 或者用yarn
yarn add react-native-restart
```
注意：如果你的React Native版本是0.60+，会自动link，不需要手动操作；如果是旧版本，需要手动link一下。
然后在RN端直接调用：
```
import RNRestart from 'react-native-restart';

// 直接调用重启
const handleRestart = () => {
    RNRestart.Restart();
};
```
小提醒：如果在Android 12+或者RN 0.70+版本遇到问题，建议去库的GitHub页面看最新的issue和解决方案，确保安装的是兼容你项目的版本。