如何在Ubuntu命令行中无头运行React Native代码以复现多设备并发Bug

核心思路 #

绕开原生模拟器，直接在Node.js环境中运行RN业务逻辑：通过Mock原生桥接模块替代RN依赖的原生能力，配置Metro生成兼容Node环境的bundle，再通过多进程实现实例隔离，以此低成本复现多设备并发场景的Bug。

分步实现 #

1. Mock原生桥接模块 #

针对业务依赖的原生模块（仅保留SQLite、网络相关，剔除UI/硬件类），用Node.js实现对应API的Mock版本：

• SQLite模块：用node-sqlite3库实现RN SQLite模块的核心方法（openDatabase、executeSql等），每个进程通过环境变量指定独立的数据库文件路径，确保数据隔离。

  // mock-native-modules/SQLite.js
  const sqlite3 = require('sqlite3').verbose();
  
  module.exports = {
    openDatabase: (name) => {
      const dbPath = process.env.SQLITE_INSTANCE_PATH || `./${name}.db`;
      return new sqlite3.Database(dbPath, (err) => {
        if (err) console.error('DB open error:', err);
      });
    },
    // 实现RN SQLite对应的其他方法，如executeSql、transaction等
  };
  

• 网络模块：直接映射RN的fetch到Node.js的fetch（Node 18+原生支持），无需额外Mock，确保能正常调用AWS后端服务。
• 其他原生依赖：如无业务逻辑依赖，直接返回空对象或空方法即可。

2. 配置Metro生成Node兼容的Bundle #

修改项目根目录的metro.config.js，调整Resolver和Transformer规则，适配Node环境：

const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config');

const config = {};

// 替换原生模块导入为Mock版本
config.resolver = {
  extraNodeModules: {
    'react-native-sqlite-storage': require.resolve('./mock-native-modules/SQLite.js'),
    // 其他需要Mock的原生模块同理配置
  },
};

// 调整Transformer，移除RN特定环境依赖
config.transformer = {
  babelTransformerPath: require.resolve('./custom-transformer.js'),
};

module.exports = mergeConfig(getDefaultConfig(__dirname), config);

自定义custom-transformer.js，确保代码转译后兼容Node：

const babelTransformer = require('metro-react-native-babel-transformer');

module.exports = {
  transform: ({ src, filename, options }) => {
    // 注入Node环境全局变量，替换RN特定变量
    const modifiedSrc = src.replace(/__DEV__/g, 'true')
                           .replace(/global\.ReactNative/g, 'global');
    return babelTransformer.transform({ src: modifiedSrc, filename, options });
  },
};

3. 编写无头入口文件 #

创建AppHeadless.js作为自定义入口，硬编码应用状态，跳过UI渲染逻辑：

import { AppRegistry } from 'react-native';
import App from './src/App'; // 原业务入口

// 硬编码初始化状态
global.appState = {
  user: { id: 'test-user-1' },
  // 其他需要的业务状态
};

// 跳过UI注册，直接启动业务逻辑
AppRegistry.registerComponent('MyApp', () => App);
// 手动触发业务逻辑初始化（根据原代码逻辑调整）
App.initialize();

4. 生成并运行Bundle #

• 生成Node兼容的bundle：

  npx metro build AppHeadless.js --platform node --out headless-bundle.js
  

• 多进程启动脚本start-multiple-instances.js，通过环境变量隔离每个实例：

  const { fork } = require('child_process');
  const instanceCount = 10; // 模拟设备数量
  
  for (let i = 0; i < instanceCount; i++) {
    const child = fork('./headless-bundle.js', [], {
      env: {
        ...process.env,
        SQLITE_INSTANCE_PATH: `./db-instance-${i}.db`,
        INSTANCE_ID: i.toString(),
      },
    });
    child.on('exit', (code) => {
      console.log(`Instance ${i} exited with code ${code}`);
    });
  }
  

• 启动多实例：

  node start-multiple-instances.js
  

关键注意事项 #

• 确保原RN代码中的异步逻辑（如Promise、async/await）与Node环境兼容，无需额外修改。
• 调试时可通过--inspect-port为每个进程指定独立调试端口，方便排查问题。
• 若原代码依赖RN特定全局对象（如DeviceInfo），需补充对应Mock实现。

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