React Native 0.71.2集成自定义字体时执行react-native-asset报错

错误原因 #

该报错是因为react-native-asset依赖的xcode库无法在iOS项目中找到Resources构建阶段，尝试访问files属性时触发null异常，多因RN 0.70+版本项目结构变化或react-native-asset版本不兼容导致。

解决方案 #

方案1：升级react-native-asset到兼容版本 #

执行以下命令更新依赖，再重新运行资源链接：

npm install react-native-asset --save-dev
# 或使用yarn
yarn add react-native-asset --dev

# 重新执行链接
npx react-native-asset

方案2：手动添加字体到iOS项目 #

如果升级工具后仍报错，可跳过自动链接，手动配置：

• 将所有.ttf字体文件拖入iOS项目的Resources目录（无该目录则新建），勾选Copy items if needed和对应的项目Target；
• 打开项目的Info.plist，添加Fonts provided by application数组字段，将每个字体的完整文件名（如CustomFont-Bold.ttf）作为数组元素填入；
• 重新运行iOS项目：npx react-native run-ios

方案3：检查iOS项目配置 #

• 确认iOS项目的.xcodeproj文件路径正确，react-native-asset需正确识别项目根目录下的iOS工程文件；
• 若使用xcworkspace，确保项目已通过pod install完成依赖安装。

内容的提问来源于stack exchange，提问作者Erich García