React Native iOS项目Xcode验证阶段Copy失败问题排查

常见操作遗漏点及解决步骤 #

• 重置Xcode衍生数据权限
  权限问题大概率出在Xcode的DerivedData目录，执行以下命令重置权限：

  sudo chown -R $(whoami):staff ~/Library/Developer/Xcode/DerivedData
  sudo chmod -R 755 ~/Library/Developer/Xcode/DerivedData
  

  之后在Xcode菜单栏选 Product > Clean Build Folder，清理完再重新归档。

• 修复项目及Pods目录权限
  很多时候pod install用了sudo会导致Pods目录权限混乱，先给整个项目目录赋权：

  sudo chown -R $(whoami):staff /你的项目实际路径
  sudo chmod -R 755 /你的项目实际路径
  

  单独处理Pods目录更稳妥：

  sudo chown -R $(whoami):staff /你的项目实际路径/Pods
  

• 给Xcode开完全磁盘访问权限
  Xcode归档时可能因权限隔离无法访问部分文件，操作步骤：

  1. 退出Xcode，打开系统设置→隐私与安全性→完全磁盘访问权限
  2. 找到Xcode并勾选，重启Xcode后再尝试归档

• 检查RN打包产物权限
  如果用react-native bundle生成的产物权限不对，会导致后续rsync失败，先删除旧的build目录：

  rm -rf ios/build
  

  再重新执行打包命令（别加sudo）：

  npx react-native bundle --platform ios --dev false --entry-file index.js --bundle-output ios/main.jsbundle --assets-dest ios/assets
  

  之后回到Xcode重新归档。

• 临时禁用并行构建
  并行构建可能引发文件锁或权限冲突，在Xcode里调整：

  1. 选中项目目标→Build Settings→搜索「Parallel Build」
  2. 把「Parallelize Build」设为NO，「Number of Parallel Build Subtasks」改为1
  3. 重新归档测试

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