React Native iOS加载多JS包遇Cannot initialize hmrClient twice问题求解

核心原因 #

你已经准确定位了问题：executeSourceCode内部调用setupHMRClientWithBundleURL时未做初始化状态检查。在打包器（Metro）模式下，主包已经完成HMR客户端初始化，加载额外包时重复触发该方法就会抛出错误；而生产模式下HMR默认关闭，因此不会出现这个问题。

可行解决方法 #

方法一：修改iOS原生代码，添加HMR初始化状态判断 #

1. 找到React Native原生桥接文件（通常是RCTBridge.mm）中executeSourceCode的实现
2. 在类中添加一个标记变量记录HMR初始化状态，然后在调用setupHMRClientWithBundleURL前做判断：

// 在RCTBridge类中添加属性
@property (nonatomic, assign) BOOL isHMRClientInitialized;

// 找到调用setupHMRClientWithBundleURL的代码段，修改为：
if (!self.isHMRClientInitialized) {
  [self setupHMRClientWithBundleURL:bundleURL];
  self.isHMRClientInitialized = YES;
}

3. 重新编译iOS项目，加载额外包时就不会重复初始化HMR客户端了。

方法二：JS层控制加载逻辑，规避重复触发 #

如果不想修改原生代码，可在JS端做环境判断：

• 检测当前是否处于开发（打包器）模式，加载额外包时跳过HMR相关初始化逻辑
• 自定义原生模块替代bridge.batchedBridge.executeSourceCode，在原生模块内部实现初始化检查逻辑，再暴露给JS调用

方法三：使用官方推荐的代码分割方案 #

如果你的React Native版本支持，直接用官方的**动态导入（Dynamic Imports）**配合Metro的代码分割配置。这种方式无需手动调用executeSourceCode，Metro会自动处理多包加载的HMR兼容问题，避免手动调用带来的底层冲突。

内容的提问来源于stack exchange，提问作者Dor Ben Baruch