iOS 引入第三方 SDK 導致 AVFoundation 報錯「未見過此類型」的排查清單

常見原因與對策

1. SDK 導入姿勢錯誤
   直接拖拽 .framework 或 .a 到項目，勾選 Copy items if needed、Create groups、目標 Target 全選。避免引用外部路徑導致頭文件找不到。
2. 缺少系統依賴庫
   第三方 SDK 往往依賴 AVFoundation、VideoToolbox、CoreMedia 等。
   Target → Build Phases → Link Binary With Libraries 添加對應 .framework。
3. ARC / MRC 混編衝突
   SDK 若為 MRC，需在 Build Phases → Compile Sources 為其文件添加 -fno-objc-arc 標誌；反之亦然。
4. Other Linker Flags 缺 -ObjC
Target → Build Settings → Other Linker Flags 必須包含 -ObjC，確保分類加載。
5. SDK 需註冊/Token
   某些直播/推流 SDK 需在 Info.plist 或代碼中配置 AppID/Token，缺失會導致運行期崩潰或編譯期符號缺失。
6. 多 SDK 衝突
   新建空項目單獨集成該 SDK 驗證；若正常，說明主項目其他第三方庫衝突（如重複符號、頭文件路徑污染）。

快速定位步驟

1. 清理構建：Cmd+Shift+K → Cmd+Option+Shift+K。
2. 刪除 DerivedData。
3. 檢查報錯文件路徑：是 SDK 內部還是系統框架？
4. 對照 SDK 官方文檔的「接入指南」逐項核對。

按清單逐項排查，90% 以上「引入三方庫導致系統框架報錯」均可解決。