React Native iOS端Swift原生桥接调用无预期日志输出问题

两个核心问题导致方法调用无输出、同时抛出线程初始化警告：

• Swift原生类未导入React基础库、未遵守RCTBridgeModule协议，原生模块注册逻辑不完整
• 未显式实现requiresMainQueueSetup方法声明模块初始化线程规则，React Native无法判断模块的线程安全要求，阻断了方法调用，同时抛出兼容性警告

1. 修改Swift原生模块代码 #

打开HelloWorld.swift，补全依赖导入、协议遵守和线程规则声明，修正后代码如下：

import React

@objc(HelloWorldModule)
class HelloWorldModule: NSObject, RCTBridgeModule {
  // 显式声明模块初始化线程规则
  @objc
  static func requiresMainQueueSetup() -> Bool {
    // 模块不涉及UI操作、无需主线程初始化时返回false，涉及UI操作则返回true
    return false
  }

  @objc
  func ShowMessage() -> Void {
    print("hello world")
  }
}

2. 确认桥接文件配置 #

当前的HelloWorld.m桥接声明配置正确，无需修改，只要确认该文件已加入iOS项目的编译源即可。

3. 清理缓存重新编译 #

原生代码修改不会通过JS热更新生效，需要执行以下命令清理缓存、重新编译原生端：

# 重新关联iOS依赖
cd ios && pod install && cd ..
# 重置Metro缓存启动服务
npx react-native start --reset-cache

新开终端窗口执行以下命令重跑iOS应用：

npx react-native run-ios

重新编译运行后，控制台不会再抛出requiresMainQueueSetup相关警告，调用NativeModules.HelloWorldModule.ShowMessage()时，终端会正常输出预期的hello world日志。

注意：如果后续在该模块中添加了涉及UI操作的逻辑（比如唤起原生弹窗、修改原生视图属性），需要将requiresMainQueueSetup的返回值改为true，保证模块在主线程初始化，避免线程安全问题。

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