Xcode 15升级后链接器错误：NSError符号指向自定义框架而非Foundation

针对你遇到的Xcode 15升级后，AJRInterface框架错误地从自定义AJRFoundation而非系统Foundation查找NSError的dyld异常，可通过以下步骤深入诊断：

1. 检查框架依赖加载顺序与链接参数 #

• 查看链接阶段的详细参数：执行以下命令获取编译链接的完整日志，重点关注AJRInterface框架的依赖顺序：

  xcodebuild -workspace YourWorkspace.xcworkspace -scheme YourScheme clean build -verbose
  

  确认Foundation是否在AJRFoundation之前被指定为依赖，Xcode 15可能调整了依赖优先级逻辑。
• 验证框架加载命令顺序：用otool查看AJRInterface的动态库加载命令：

  otool -l AJRInterface.framework/AJRInterface | grep -A 5 -B 5 LC_LOAD_DYLIB
  

  检查系统Foundation的加载条目是否排在AJRFoundation之前，加载顺序直接影响符号查找优先级。

2. 精准分析符号引用与导出 #

• 解析Swift符号的实际引用：先用nm提取符号，再用swift-demangle还原Swift原名，避免otool的兼容性问题：

  nm -gU AJRInterface.framework/AJRInterface | grep NSError | swift-demangle
  

  确认NSError符号的目标绑定是否异常。
• 检查AJRFoundation的符号导出：排查是否存在意外导出的与NSError相关的符号：

  nm -gU AJRFoundation.framework/AJRFoundation | grep -i error
  

• 使用Xcode 15新增的dyld_info工具：该工具对Swift符号支持更友好，能清晰展示符号的预期查找框架：

  dyld_info -symbols AJRInterface.framework/AJRInterface
  

3. 排查混编与编译配置问题 #

• 检查AJRFoundation的模块定义：查看其modulemap文件或自动生成的Swift.h头文件，确认是否存在NSError的类别、扩展或类型别名，导致编译器错误绑定符号。
• 核对编译设置：检查AJRInterface的Build Settings，重点关注：
  • Other Linker Flags：是否存在强制指定依赖顺序的参数
  • Framework Search Paths：是否意外将自定义框架路径排在系统框架之前
  • Swift Compiler - General下的Import Paths：是否有异常的导入配置
• 隔离依赖测试：临时移除AJRInterface对AJRFoundation的依赖，编译后检查NSError的符号引用是否恢复指向Foundation，以此确认问题是否由两者的交互导致。

4. 构建最小测试用例定位根源 #

• 逐步简化代码：创建新的Xcode项目，先添加AJRFoundation的基础结构，再添加AJRInterface的核心代码，每次编译后测试是否触发dyld错误，定位到具体的代码片段或配置项。
• 跨版本对比编译产物：分别用Xcode 14和Xcode 15编译同一个最小项目，对比两者的dyld_info或nm输出，找出符号绑定的差异点，确认是否为工具链bug。

临时添加代码的方案仅能应急，建议通过上述步骤定位问题根源。若确认是Xcode 15工具链的bug，即可基于最小用例提交至Apple Bug Tracker。

内容的提问来源于stack exchange，提问作者A.J. Raftis