You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native iOS构建错误:M3 Mac提示‘No Type or Protocol Named RCTBridgeModule’

React Native 0.73.1集成LiveKit后iOS构建报错"No Type or Protocol named 'RCTBridgeModule'"解决方案

针对你遇到的iOS专属构建报错问题,试试以下几个针对性方案:

1. 修正LiveKit模块的头文件导入路径

RN 0.70+版本拆分了React Core模块,头文件路径发生变化。找到LiveKit iOS模块中引用RCTBridgeModule的文件,将原导入语句:

#import <React/RCTBridgeModule.h>

替换为:

#import <React-Core/RCTBridgeModule.h>

如果是Swift文件,确保桥接文件(.h)中正确引入了React-Core/RCTBridgeModule.h。

2. 彻底清理构建缓存与产物

  • 执行命令清空iOS构建目录:
    rm -rf ios/build
    
  • 关闭Xcode,删除Derived Data:打开Xcode → 点击顶部菜单栏Xcode→Settings→Locations,找到Derived Data目录点击箭头打开文件夹,删除所有内容。
  • 进入ios目录重新执行:
    pod deintegrate && pod install
    

3. 检查Xcode Build Settings配置

打开Xcode的.xcworkspace文件,选中项目目标,进入Build Settings:

  • 找到Header Search Paths,确保包含以下路径并设置为Recursive:
    • $(inherited)
    • $(SRCROOT)/../node_modules/react-native/React
    • $(SRCROOT)/../node_modules/react-native/React-Core
  • 找到Framework Search Paths,添加:
    • $(inherited)
    • $(SRCROOT)/../node_modules/react-native/React

4. 验证LiveKit版本兼容性

确认你使用的LiveKit React Native版本支持RN 0.73.1。如果版本过旧,尝试升级到最新兼容版本:

npm install livekit-react-native@latest
# 或 yarn add livekit-react-native@latest

5. 用Xcode直接构建排查

打开.xcworkspace后,先执行Command+Shift+K清理构建文件夹,然后点击Product→Build重新构建,查看是否有更详细的错误提示,定位是否是特定文件导致的问题。

内容的提问来源于stack exchange,提问作者bubblebop

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.03 03:15:08