React Native CLI项目添加相机包未导入即构建失败求助

核心原因 #

哪怕你没在JS代码里导入相机包，React Native的Autolinking机制也会自动把第三方库的原生代码（iOS/Android部分）整合到项目里。相机类库必须依赖权限配置和原生环境适配，而你的默认项目没添加这些必要配置，所以一整合就会触发构建失败。

具体修复步骤 #

1. 补全iOS权限配置 #

打开iOS项目的Info.plist（路径：ios/[你的项目名]/Info.plist），添加相机相关权限描述：

<key>NSCameraUsageDescription</key>
<string>需要访问相机拍摄照片/视频</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册保存媒体文件</string>
<!-- 如果需要录制视频，再加麦克风权限 -->
<key>NSMicrophoneUsageDescription</key>
<string>需要访问麦克风录制视频音频</string>

2. 补全Android权限配置 #

打开Android项目的AndroidManifest.xml（路径：android/app/src/main/AndroidManifest.xml），在<manifest>标签内添加权限：

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<!-- 视频录制需要麦克风权限 -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />

3. 清理缓存后重新构建 #

• 清理npm缓存：npm cache clean --force
• 处理iOS依赖：

  cd ios
  pod deintegrate
  pod install
  cd ..
  

• 清理Android构建缓存：

  cd android
  ./gradlew clean
  cd ..
  

• 重新启动项目：npx react-native run-ios 或 npx react-native run-android

4. 确认库版本兼容 #

部分相机库对RN版本有明确要求，比如react-native-vision-camera v3.x需要RN 0.70+，你的0.71.1是符合的，但如果是其他冷门或旧版相机库，可能存在版本不兼容问题。建议优先选官方文档标注支持RN 0.71.x的库。

额外提示 #

如果以上步骤没用，试试手动链接（虽然RN 0.60+默认Autolinking，但少数特殊库可能需要）：

• iOS：把库的原生文件手动拖入Xcode项目
• Android：按照对应库的官方文档，在settings.gradle和build.gradle里添加依赖配置

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