私有XCFramework加载后出现EXC_BAD_ACCESS崩溃问题求助

核心触发原因排查 #

1. 依赖符号重复冲突 #

这是static let处崩溃最常见的诱因：构建XCFramework时将依赖的Pod库静态符号打包到了自身产物中，主项目集成时又重复引入了相同的Pod依赖，导致静态变量被多次初始化、内存地址冲突，访问时触发野指针。
解决方法：

• 编写私有库podspec时，仅通过dependency字段声明第三方Pod依赖，不要将依赖库的编译产物打包到XCFramework中
• 检查XCFramework构建脚本的依赖嵌入配置，关闭依赖库的静态嵌入逻辑

2. 符号可见性配置错误 #

• 检查XCFramework编译配置中的Symbols Hidden by Default选项，对外暴露的Swift类、静态属性需声明为public/open访问级别，禁止使用internal及更低权限
• 混编场景下确认SWIFT_INSTALL_OBJC_HEADER配置正确，对外暴露的Swift符号已正确生成桥接声明

3. 构建配置不匹配 #

• 验证XCFramework包含的架构切片与主项目构建目标匹配：真机需包含arm64架构，M系列芯片模拟器需包含arm64切片，Intel模拟器需包含x86_64切片
• 确认XCFramework的Deployment Target版本不高于主项目的最低支持系统版本

4. 初始化线程安全问题 #

Swift static let本身为线程安全，但若其初始化过程依赖非线程安全的全局变量、跨模块调用逻辑，多线程并发触发初始化时也可能出现野指针。可在静态变量初始化处添加断点，排查是否存在多线程同时调用的场景

快速验证方法 #

将XCFramework对应的源码直接拖入主项目编译运行，若崩溃消失即可确认是XCFramework打包配置、依赖冲突问题，无需排查业务逻辑代码。

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