嵌套XCFramework执行xcodebuild报错DebugSymbolsPath缺失，本地正常CI失败

核心原因 #

本地编译正常但CircleCI报错，本质是CI环境里嵌套XCFramework的dSYM文件要么丢失，要么主框架Info.plist里的路径配置和CI的目录结构不匹配，导致xcodebuild找不到指定的调试符号文件。

具体解决步骤 #

• 验证嵌套框架的完整性
  在CI任务拉取嵌套XCFramework后，先执行命令检查dSYM是否存在：

  find path/to/your-nested.xcframework -name "*.dSYM"
  

  如果没有输出结果，说明嵌套框架的dSYM在CI环境中丢失，需要调整框架的分发方式——比如确保打包时强制包含dSYM，或者CI拉取的是完整的XCFramework压缩包。

• 修正主框架Info.plist的路径配置
  打开主XCFramework的Info.plist，找到对应嵌套框架的DebugSymbolsPath条目，核对路径是否和CI环境中的实际目录结构一致。如果用的是相对路径，要保证主框架和嵌套框架的相对位置和本地完全相同。

• 调整CI的xcodebuild命令参数
  在CI的编译命令中添加参数，强制关联调试符号：

  xcodebuild -workspace YourProject.xcworkspace -scheme YourMainFramework -configuration Release -destination 'generic/platform=iOS' -archivePath ./build/MainFramework.xcarchive archive DEBUG_INFORMATION_FORMAT=dwarf-with-dsym
  

  如果暂时不需要调试符号（不推荐，会影响崩溃分析），也可以临时关闭：

  xcodebuild ... DEBUG_INFORMATION_FORMAT=dwarf
  

• 清理CI缓存
  如果CircleCI使用了缓存功能，可能缓存的XCFramework是缺失dSYM的不完整版本。需要清理旧缓存，重新拉取完整的框架包，或者修改缓存策略，确保缓存的是包含dSYM的完整XCFramework。

• 重新打包嵌套XCFramework
  确保嵌套框架打包时正确包含dSYM，使用以下命令生成XCFramework：

  xcodebuild -create-xcframework -framework path/to/NestedFramework.framework -debug-symbols path/to/NestedFramework.framework.dSYM -output NestedFramework.xcframework
  

  这样生成的XCFramework会在Info.plist中正确写入DebugSymbolsPath，且包含完整的调试符号文件。

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