CocoaPods依赖库加载失败求助（Thread 1: signal SIGABRT）

问题描述 #

运行iOS应用时触发Thread 1: signal SIGABRT，报错核心为动态库AlgoliaSearchClient.framework无法加载，但实际问题并非Algolia本身导致——移除该库后会出现其他依赖库的同类错误，说明根源是CocoaPods或Xcode的配置问题。已尝试以下操作但未解决：

• 清理构建文件夹
• 删除派生数据
• 重启Mac
• 卸载并重新安装所有Pods

报错详情：

dyld[1057]: Library not loaded:
 @rpath/AlgoliaSearchClient.framework/AlgoliaSearchClient Referenced from: <EFE10BCF-D1E4-32F9-9D3B-BC496485BF96>
 /private/var/containers/Bundle/Application/B7356B54-300C-462B-8D92-61C64A9342F8/Flash.app/Flash
 Reason: tried:
 '/usr/lib/swift/AlgoliaSearchClient.framework/AlgoliaSearchClient' (no
 such file, not in dyld cache),
 '/private/preboot/Cryptexes/OS/usr/lib/swift/AlgoliaSearchClient.framework/AlgoliaSearchClient'
 (no such file),
 '/private/var/containers/Bundle/Application/B7356B54-300C-462B-8D92-61C64A9342F8/Flash.app/Frameworks/AlgoliaSearchClient.framework/AlgoliaSearchClient'
 (no such file),
 '/private/var/containers/Bundle/Application/B7356B54-300C-462B-8D92-61C64A9342F8/Flash.app/Frameworks/AlgoliaSearchClient.framework/AlgoliaSearchClient'
 (no such file),
 '/private/var/containers/Bundle/Application/B7356B54-300C-462B-8D92-61C64A9342F8/Flash.app/Frameworks/AlgoliaSearchClient.framework/AlgoliaSearchClient'
 (no such file),
 '/usr/lib/swift/AlgoliaSearchClient.framework/AlgoliaSearchClient' (no
 such file, not in dyld cache),
 '/private/preboot/Cryptexes/OS/usr/lib/swift/AlgoliaSearchClient.framework/AlgoliaSearchClient'
 (no such file),
 '/private/var/containers/Bundle/Application/B7356B54-300C-462B-8D92-61C64A9342F8/Flash.app/Frameworks/AlgoliaSearchClient.framework/AlgoliaSearchClient'
 (no such file),
 '/private/var/containers/Bundle/Application/B7356B54-300C-462B-8D92-61C64A9342F8/Flash.app/Frameworks/AlgoliaSearchClient.framework/AlgoliaSearchClient'
 (no such file),
 '/private/var/containers/Bundle/Application/B7356B54-300C-462B-8D92-61C64A9342F8/Flash.app/Frameworks/AlgoliaSearchClient.framework/AlgoliaSearchClient'
 (no such file),
 '/System/Library/Frameworks/AlgoliaSearchClient.framework/AlgoliaSearchClient'
 (no such file, not in dyld cache) (lldb)

解决方法 #

1. 检查Framework搜索路径配置 #

• 打开项目Build Settings，搜索Framework Search Paths
• 确保路径包含$(inherited)，且${PODS_ROOT}/**存在（CocoaPods自动生成的搜索路径）
• 避免手动添加绝对路径，优先使用相对路径与继承配置

2. 验证Embed Frameworks配置 #

• 进入项目Build Phases，查看Embed Frameworks阶段
• 确认所有第三方依赖框架已添加，且Code Sign On Copy选项已勾选
• 若缺失，重新执行pod install后检查是否自动补全

3. 统一CocoaPods集成模式 #

• 如果之前混用静态/动态库，在Podfile中添加静态库集成配置：

  use_frameworks! :linkage => :static
  

• 执行pod install重新生成依赖配置，避免动态库加载冲突

4. 深度重置构建环境 #

• 终端执行以下命令清理缓存：

  rm -rf ~/Library/Caches/CocoaPods
  rm -rf Pods
  rm -rf ~/Library/Developer/Xcode/DerivedData
  pod deintegrate
  pod setup
  pod install
  

• 打开Xcode后，执行Product > Clean Build Folder（快捷键Cmd+Shift+K），再重新构建

5. 检查Runpath Search Paths #

• 在Build Settings中搜索Runpath Search Paths
• 确保包含@executable_path/Frameworks和@loader_path/Frameworks，这是动态库加载的核心路径

6. 验证签名配置 #

• 进入项目Signing & Capabilities，确认签名证书与Provisioning Profile有效
• 真机调试时，确保设备已添加到开发者账号，且配置文件包含该设备

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