Xcode Archive归档时报framework not found AppAuth错误求助

问题复现场景 #

• 项目仅使用Swift Package Manager（SPM，即Packages）管理依赖，未集成CocoaPods
• 真机Debug运行完全正常，仅执行Archive操作时触发链接失败
• 报错截图：
  
• 核心报错日志：

ld: framework not found AppAuth
clang: error: linker command failed with exit code 1 (use -v to see invocation)

对应修复步骤 #

按顺序排查，绝大多数同类问题在前3步即可解决：

• 清理残留链接配置
  选中主项目Target，打开Build Settings标签页：
  1. 搜索Framework Search Paths，分别展开Debug、Release两个配置分支，删除所有指向旧Pods目录、本地不存在路径的AppAuth相关条目，仅保留Xcode自动生成的SPM默认路径即可
  2. 搜索Other Linker Flags，同样检查Release配置下有没有手动硬编码的-framework "AppAuth"条目，有则直接删除——SPM会自动注入链接参数，手动添加的硬编码在Release配置下很容易出现路径匹配失败
  3. 搜索Excluded Architectures，检查Release配置下有没有错误添加arm64架构的排除规则，有则删除；同时确认Build Active Architecture Only项的Release值为No，避免归档时只构建当前连接设备的架构导致依赖缺失
• 校验SPM依赖关联正确性
  切到Target的General标签页，滑到最底部Frameworks, Libraries, and Embedded Content区域：
  1. 找到AppAuth条目，确认其Platforms选项选择为All Platforms，不要限定为Debug模式或特定模拟器平台
  2. 如果项目包含Widget、应用扩展、Watch端App等子Target，逐个检查子Target的依赖列表：不需要用到AppAuth的Target直接删除AppAuth关联条目；需要用到的Target，在SPM依赖列表里重新勾选对应Target的关联，不要手动拖拽framework文件建立链接
• 重置缓存重新解析依赖
  1. 关闭Xcode，终端执行rm -rf ~/Library/Developer/Xcode/DerivedData删除所有派生数据
  2. 重新打开项目，点击菜单栏File -> Packages -> Reset Package Caches，等待依赖重新拉取解析完成
  3. 清理完成后重新执行Archive操作即可

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