排查React Native中iOS原生模块加载失败问题

我之前也踩过Djinni生成RN原生模块的注册坑，结合你描述的情况，核心问题在于Djinni的模块注册逻辑和RN官方文档的常规写法有差异，下面给你拆解原因和具体解决办法：

为什么示例不用RCT_EXPORT_MODULE()也能正常运行？ #

Djinni生成的OC模块通常会通过自动注册机制绕过显式的RCT_EXPORT_MODULE()宏，常见的实现方式有两种：

• 生成了单独的注册代码，比如在某个全局文件里调用RCTRegisterModule(YourModuleClass)，这个函数可以直接把模块注册到RN桥接器，不需要在类内部写宏。
• 部分Djinni模板会生成一个注册管理器类，在App启动时批量注册所有生成的模块，比如[DjinniModuleRegistry registerAllModules]，示例项目大概率在AppDelegate.m或者初始化代码里调用了这个方法。

你的项目加载失败的排查&解决步骤 #

1. 检查Djinni生成的注册代码是否被正确编译 #

• 打开Xcode的Build Phases -> Compile Sources，确认是否包含Djinni生成的类似xxxRegistry.m或者xxxModuleRegistrar.m的文件，如果没有，把这些文件添加到编译列表中。
• 在项目内搜索RCTRegisterModule调用，确认你的目标模块类被正确注册了。

2. 补全App启动时的模块注册逻辑 #

如果示例项目里有初始化注册的代码，比如在AppDelegate.m的didFinishLaunchingWithOptions方法中：

// 示例中的注册代码，你需要复制到自己的项目里
#import "DjinniModuleRegistry.h"

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  // ...其他RN初始化代码
  [DjinniModuleRegistry registerAllModules];
  return YES;
}

确保你自己的项目里也调用了这个注册方法。

3. 手动添加RCT_EXPORT_MODULE()宏（最直接的兜底方案） #

如果找不到自动注册的逻辑，直接在Djinni生成的模块类的实现块里添加这个宏：

@implementation YourGeneratedModule
RCT_EXPORT_MODULE() // 手动添加这一行，放在@implementation之后

// 下面是Djinni生成的其他代码
@end

同时确认你的类已经遵循了RCTBridgeModule协议，Djinni生成的类默认会继承NSObject并实现这个协议，不过可以检查一下.h文件：

@interface YourGeneratedModule : NSObject <RCTBridgeModule>
@end

4. 验证模块是否被注册成功 #

在RN侧的代码里打印所有已注册的原生模块，确认你的模块是否在列表中：

import { NativeModules } from 'react-native';

console.log('已注册的原生模块:', Object.keys(NativeModules));

如果还是没出现，查看Xcode的编译日志，排查是否有“类未找到”“协议未实现”这类警告或错误。

5. 检查Djinni版本差异 #

如果你使用的Djinni版本和示例不同，注册逻辑可能有变化，建议查看当前Djinni版本的文档，确认它生成RN模块的注册要求。

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